{"openapi":"3.1.0","info":{"title":"云途内容采集 API","version":"1.0.0","description":"面向已注册云途账号的内容采集接口。积分与官网账户余额共用。成功响应只包含稳定、统一命名的业务字段，不返回上游原始响应。"},"servers":[{"url":"https://www.yuntuagi.cn","description":"云途正式服务"}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"http","scheme":"bearer","bearerFormat":"ytk_..."}},"schemas":{"Profile":{"type":["object","null"],"additionalProperties":false,"properties":{"name":{"type":"string"},"id":{"type":"string"},"home_url":{"type":"string"},"avatar_url":{"type":"string"},"signature":{"type":"string"},"metrics":{"type":"object","additionalProperties":false,"properties":{"followers":{"type":["number","null"]},"following":{"type":["number","null"]},"likes":{"type":["number","null"]},"works":{"type":["number","null"]}}},"attributes":{"type":"object","additionalProperties":true,"description":"可用的认证、地区或频道扩展资料。"}}},"Work":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"title":{"type":"string"},"caption":{"type":"string"},"source_url":{"type":"string"},"author":{"type":"object"},"published_at":{},"duration_seconds":{"type":["number","null"]},"media":{"type":"object","additionalProperties":false,"properties":{"video_url":{"type":"string"},"cover_url":{"type":"string"},"image_urls":{"type":"array","items":{"type":"string"}},"music_url":{"type":"string"}}},"metrics":{"type":"object","additionalProperties":false},"tags":{"type":"array","items":{"type":"string"}},"platform":{"type":"string"}}},"Pagination":{"type":"object","additionalProperties":false,"properties":{"cursor":{"type":"string"},"next_cursor":{"type":"string"},"has_more":{"type":"boolean"},"total":{"type":["number","null"]}}},"CollectionResponse":{"type":"object","additionalProperties":false,"properties":{"ok":{"type":"boolean"},"request_id":{"type":"string"},"endpoint":{"type":"string"},"platform":{"type":"string","description":"本次采集的平台标识，例如 douyin、xiaohongshu。"},"cost_points":{"type":"string"},"balance_points":{"type":"string"},"latency_ms":{"type":"integer"},"error":{"type":["string","null"]},"data":{"type":["object","null"],"description":"已清洗并统一命名的内容数据；不会返回上游原始响应。","additionalProperties":false,"properties":{"schema_version":{"type":"string"},"platform":{"type":"string"},"kind":{"type":"string","enum":["single_work","profile","profile_posts"]},"profile":{"$ref":"#/components/schemas/Profile"},"works":{"type":"array","items":{"$ref":"#/components/schemas/Work"}},"pagination":{"$ref":"#/components/schemas/Pagination"}}}}}}},"paths":{"/v1/media/douyin-video-info":{"post":{"summary":"抖音单条作品采集（兼容）","description":"通过 aweme_id 或分享链接获取单条作品；保留给已发布客户端。 成功调用消耗 20 积分。","operationId":"collect_douyin_video_info","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":128},"description":"每个业务请求使用一个永不复用的唯一标识；完成后的响应可在 24 小时内安全重放，不会重复执行或扣费。"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["aweme_id"],"properties":{"aweme_id":{"type":"string","description":"抖音作品 ID","example":"7592116912205630761"}},"example":{"aweme_id":"7592116912205630761"}},"example":{"aweme_id":"7592116912205630761"}}}},"responses":{"200":{"description":"采集成功，响应为统一清洗后的字段。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponse"}}}},"400":{"description":"请求参数不正确"},"401":{"description":"API Key 无效或已到期"},"402":{"description":"积分余额不足"},"404":{"description":"接口不存在"},"409":{"description":"幂等键冲突"},"422":{"description":"请求字段不符合接口约定"},"429":{"description":"调用过快或达到每日积分上限"},"502":{"description":"内容采集暂时失败"}}}},"/v1/media/douyin-user":{"post":{"summary":"抖音主页作品采集","description":"通过 sec_user_id 分页获取用户主页作品，支持最新或最热排序。 成功调用消耗 200 积分。","operationId":"collect_douyin_user","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":128},"description":"每个业务请求使用一个永不复用的唯一标识；完成后的响应可在 24 小时内安全重放，不会重复执行或扣费。"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["sec_user_id"],"properties":{"sec_user_id":{"type":"string","description":"平台用户标识","example":"MS4wLjABAAAA_example"},"max_cursor":{"type":"integer","description":"分页游标，首页传 0","example":0},"count":{"type":"integer","description":"返回数量","example":20},"sort_type":{"type":"integer","description":"排序类型","example":0}},"example":{"sec_user_id":"MS4wLjABAAAA_example","max_cursor":0,"count":20,"sort_type":0}},"example":{"sec_user_id":"MS4wLjABAAAA_example","max_cursor":0,"count":20,"sort_type":0}}}},"responses":{"200":{"description":"采集成功，响应为统一清洗后的字段。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponse"}}}},"400":{"description":"请求参数不正确"},"401":{"description":"API Key 无效或已到期"},"402":{"description":"积分余额不足"},"404":{"description":"接口不存在"},"409":{"description":"幂等键冲突"},"422":{"description":"请求字段不符合接口约定"},"429":{"description":"调用过快或达到每日积分上限"},"502":{"description":"内容采集暂时失败"}}}},"/v1/media/xiaohongshu-note-info":{"post":{"summary":"小红书单条图文笔记采集（兼容）","description":"通过分享文本、链接或 note_id 获取单条图文笔记；旧 slug 保留给已发布客户端。 成功调用消耗 200 积分。","operationId":"collect_xiaohongshu_note_info","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":128},"description":"每个业务请求使用一个永不复用的唯一标识；完成后的响应可在 24 小时内安全重放，不会重复执行或扣费。"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["note_id"],"properties":{"note_id":{"type":"string","description":"小红书笔记 ID","example":"697c0eee000000000a03c308"}},"example":{"note_id":"697c0eee000000000a03c308"}},"example":{"note_id":"697c0eee000000000a03c308"}}}},"responses":{"200":{"description":"采集成功，响应为统一清洗后的字段。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponse"}}}},"400":{"description":"请求参数不正确"},"401":{"description":"API Key 无效或已到期"},"402":{"description":"积分余额不足"},"404":{"description":"接口不存在"},"409":{"description":"幂等键冲突"},"422":{"description":"请求字段不符合接口约定"},"429":{"description":"调用过快或达到每日积分上限"},"502":{"description":"内容采集暂时失败"}}}},"/v1/media/xiaohongshu-user-notes":{"post":{"summary":"小红书主页笔记采集","description":"通过用户主页分享文本或 user_id 分页获取主页笔记。 成功调用消耗 2000 积分。","operationId":"collect_xiaohongshu_user_notes","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":128},"description":"每个业务请求使用一个永不复用的唯一标识；完成后的响应可在 24 小时内安全重放，不会重复执行或扣费。"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["user_id"],"properties":{"user_id":{"type":"string","description":"平台用户 ID","example":"61b46d790000000010008153"},"cursor":{"type":"string","description":"分页游标，首页留空","example":""}},"example":{"user_id":"61b46d790000000010008153","cursor":""}},"example":{"user_id":"61b46d790000000010008153","cursor":""}}}},"responses":{"200":{"description":"采集成功，响应为统一清洗后的字段。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponse"}}}},"400":{"description":"请求参数不正确"},"401":{"description":"API Key 无效或已到期"},"402":{"description":"积分余额不足"},"404":{"description":"接口不存在"},"409":{"description":"幂等键冲突"},"422":{"description":"请求字段不符合接口约定"},"429":{"description":"调用过快或达到每日积分上限"},"502":{"description":"内容采集暂时失败"}}}},"/v1/media/bilibili-video-info":{"post":{"summary":"B站单条视频采集","description":"通过 B站视频链接或视频标识获取单条视频信息。 成功调用消耗 20 积分。","operationId":"collect_bilibili_video_info","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":128},"description":"每个业务请求使用一个永不复用的唯一标识；完成后的响应可在 24 小时内安全重放，不会重复执行或扣费。"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["url"],"properties":{"url":{"type":"string","description":"作品页链接","example":"https://www.bilibili.com/video/BV1S5uKzzE4r"}},"example":{"url":"https://www.bilibili.com/video/BV1S5uKzzE4r"}},"example":{"url":"https://www.bilibili.com/video/BV1S5uKzzE4r"}}}},"responses":{"200":{"description":"采集成功，响应为统一清洗后的字段。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponse"}}}},"400":{"description":"请求参数不正确"},"401":{"description":"API Key 无效或已到期"},"402":{"description":"积分余额不足"},"404":{"description":"接口不存在"},"409":{"description":"幂等键冲突"},"422":{"description":"请求字段不符合接口约定"},"429":{"description":"调用过快或达到每日积分上限"},"502":{"description":"内容采集暂时失败"}}}},"/v1/media/bilibili-user-videos":{"post":{"summary":"B站主页投稿采集","description":"通过 UID 分页获取主页投稿，支持发布时间、播放量或收藏量排序。 成功调用消耗 200 积分。","operationId":"collect_bilibili_user_videos","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":128},"description":"每个业务请求使用一个永不复用的唯一标识；完成后的响应可在 24 小时内安全重放，不会重复执行或扣费。"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["uid"],"properties":{"uid":{"type":"string","description":"平台用户 UID","example":"178360345"},"pn":{"type":"integer","description":"页码","example":1},"ps":{"type":"integer","description":"每页数量","example":25},"order":{"type":"string","description":"排序方式","example":"pubdate"}},"example":{"uid":"178360345","pn":1,"ps":25,"order":"pubdate"}},"example":{"uid":"178360345","pn":1,"ps":25,"order":"pubdate"}}}},"responses":{"200":{"description":"采集成功，响应为统一清洗后的字段。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponse"}}}},"400":{"description":"请求参数不正确"},"401":{"description":"API Key 无效或已到期"},"402":{"description":"积分余额不足"},"404":{"description":"接口不存在"},"409":{"description":"幂等键冲突"},"422":{"description":"请求字段不符合接口约定"},"429":{"description":"调用过快或达到每日积分上限"},"502":{"description":"内容采集暂时失败"}}}},"/v1/media/bilibili-user-videos-app":{"post":{"summary":"B站主页投稿采集备用","description":"通过 UID 获取 B站用户投稿列表，作为主页采集备用线路。 成功调用消耗 200 积分。","operationId":"collect_bilibili_user_videos_app","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":128},"description":"每个业务请求使用一个永不复用的唯一标识；完成后的响应可在 24 小时内安全重放，不会重复执行或扣费。"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["user_id"],"properties":{"user_id":{"type":"string","description":"平台用户 ID","example":"203680252"},"post_filter":{"type":"string","description":"请求参数 post_filter","example":"archive"},"page":{"type":"integer","description":"页码","example":1},"ps":{"type":"integer","description":"每页数量","example":20}},"example":{"user_id":"203680252","post_filter":"archive","page":1,"ps":20}},"example":{"user_id":"203680252","post_filter":"archive","page":1,"ps":20}}}},"responses":{"200":{"description":"采集成功，响应为统一清洗后的字段。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponse"}}}},"400":{"description":"请求参数不正确"},"401":{"description":"API Key 无效或已到期"},"402":{"description":"积分余额不足"},"404":{"description":"接口不存在"},"409":{"description":"幂等键冲突"},"422":{"description":"请求字段不符合接口约定"},"429":{"description":"调用过快或达到每日积分上限"},"502":{"description":"内容采集暂时失败"}}}},"/v1/media/kuaishou-video-info":{"post":{"summary":"快手单条作品采集","description":"通过快手作品分享链接获取单条作品信息。 成功调用消耗 40 积分。","operationId":"collect_kuaishou_video_info","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":128},"description":"每个业务请求使用一个永不复用的唯一标识；完成后的响应可在 24 小时内安全重放，不会重复执行或扣费。"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["share_text"],"properties":{"share_text":{"type":"string","description":"包含分享链接的文本","example":"https://v.kuaishou.com/example"}},"example":{"share_text":"https://v.kuaishou.com/example"}},"example":{"share_text":"https://v.kuaishou.com/example"}}}},"responses":{"200":{"description":"采集成功，响应为统一清洗后的字段。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponse"}}}},"400":{"description":"请求参数不正确"},"401":{"description":"API Key 无效或已到期"},"402":{"description":"积分余额不足"},"404":{"description":"接口不存在"},"409":{"description":"幂等键冲突"},"422":{"description":"请求字段不符合接口约定"},"429":{"description":"调用过快或达到每日积分上限"},"502":{"description":"内容采集暂时失败"}}}},"/v1/media/kuaishou-user-posts":{"post":{"summary":"快手主页作品采集","description":"通过用户 ID 分页获取快手主页作品列表。 成功调用消耗 2000 积分。","operationId":"collect_kuaishou_user_posts","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":128},"description":"每个业务请求使用一个永不复用的唯一标识；完成后的响应可在 24 小时内安全重放，不会重复执行或扣费。"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["user_id"],"properties":{"user_id":{"type":"string","description":"平台用户 ID","example":"903511772"},"pcursor":{"type":"string","description":"分页游标，首页留空","example":""}},"example":{"user_id":"903511772","pcursor":""}},"example":{"user_id":"903511772","pcursor":""}}}},"responses":{"200":{"description":"采集成功，响应为统一清洗后的字段。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponse"}}}},"400":{"description":"请求参数不正确"},"401":{"description":"API Key 无效或已到期"},"402":{"description":"积分余额不足"},"404":{"description":"接口不存在"},"409":{"description":"幂等键冲突"},"422":{"description":"请求字段不符合接口约定"},"429":{"description":"调用过快或达到每日积分上限"},"502":{"description":"内容采集暂时失败"}}}},"/v1/media/tiktok-video-info":{"post":{"summary":"TikTok 单条作品采集","description":"通过 TikTok 分享链接获取单条作品信息。 成功调用消耗 20 积分。","operationId":"collect_tiktok_video_info","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":128},"description":"每个业务请求使用一个永不复用的唯一标识；完成后的响应可在 24 小时内安全重放，不会重复执行或扣费。"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["share_url"],"properties":{"share_url":{"type":"string","description":"作品分享链接","example":"https://www.tiktok.com/t/example/"}},"example":{"share_url":"https://www.tiktok.com/t/example/"}},"example":{"share_url":"https://www.tiktok.com/t/example/"}}}},"responses":{"200":{"description":"采集成功，响应为统一清洗后的字段。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponse"}}}},"400":{"description":"请求参数不正确"},"401":{"description":"API Key 无效或已到期"},"402":{"description":"积分余额不足"},"404":{"description":"接口不存在"},"409":{"description":"幂等键冲突"},"422":{"description":"请求字段不符合接口约定"},"429":{"description":"调用过快或达到每日积分上限"},"502":{"description":"内容采集暂时失败"}}}},"/v1/media/tiktok-user-videos":{"post":{"summary":"TikTok 主页作品采集","description":"通过 sec_user_id 或 unique_id 分页获取 TikTok 主页作品。 成功调用消耗 200 积分。","operationId":"collect_tiktok_user_videos","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":128},"description":"每个业务请求使用一个永不复用的唯一标识；完成后的响应可在 24 小时内安全重放，不会重复执行或扣费。"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["sec_user_id"],"properties":{"sec_user_id":{"type":"string","description":"平台用户标识","example":"MS4wLjABAAAA_example"},"max_cursor":{"type":"integer","description":"分页游标，首页传 0","example":0},"count":{"type":"integer","description":"返回数量","example":20},"sort_type":{"type":"integer","description":"排序类型","example":0}},"example":{"sec_user_id":"MS4wLjABAAAA_example","max_cursor":0,"count":20,"sort_type":0}},"example":{"sec_user_id":"MS4wLjABAAAA_example","max_cursor":0,"count":20,"sort_type":0}}}},"responses":{"200":{"description":"采集成功，响应为统一清洗后的字段。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponse"}}}},"400":{"description":"请求参数不正确"},"401":{"description":"API Key 无效或已到期"},"402":{"description":"积分余额不足"},"404":{"description":"接口不存在"},"409":{"description":"幂等键冲突"},"422":{"description":"请求字段不符合接口约定"},"429":{"description":"调用过快或达到每日积分上限"},"502":{"description":"内容采集暂时失败"}}}},"/v1/media/douyin-video-v3":{"post":{"summary":"抖音单条作品采集","description":"通过 aweme_id 获取视频、图文、文章或短剧等单条作品详情。 成功调用消耗 20 积分。","operationId":"collect_douyin_video_v3","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":128},"description":"每个业务请求使用一个永不复用的唯一标识；完成后的响应可在 24 小时内安全重放，不会重复执行或扣费。"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["aweme_id"],"properties":{"aweme_id":{"type":"string","description":"抖音作品 ID","example":"7592116912205630761"}},"example":{"aweme_id":"7592116912205630761"}},"example":{"aweme_id":"7592116912205630761"}}}},"responses":{"200":{"description":"采集成功，响应为统一清洗后的字段。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponse"}}}},"400":{"description":"请求参数不正确"},"401":{"description":"API Key 无效或已到期"},"402":{"description":"积分余额不足"},"404":{"description":"接口不存在"},"409":{"description":"幂等键冲突"},"422":{"description":"请求字段不符合接口约定"},"429":{"description":"调用过快或达到每日积分上限"},"502":{"description":"内容采集暂时失败"}}}},"/v1/media/douyin-video-by-url":{"post":{"summary":"抖音分享链接采集","description":"通过抖音分享链接解析并获取单条作品详情。 成功调用消耗 20 积分。","operationId":"collect_douyin_video_by_url","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":128},"description":"每个业务请求使用一个永不复用的唯一标识；完成后的响应可在 24 小时内安全重放，不会重复执行或扣费。"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["share_url"],"properties":{"share_url":{"type":"string","description":"作品分享链接","example":"https://v.douyin.com/example/"}},"example":{"share_url":"https://v.douyin.com/example/"}},"example":{"share_url":"https://v.douyin.com/example/"}}}},"responses":{"200":{"description":"采集成功，响应为统一清洗后的字段。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponse"}}}},"400":{"description":"请求参数不正确"},"401":{"description":"API Key 无效或已到期"},"402":{"description":"积分余额不足"},"404":{"description":"接口不存在"},"409":{"description":"幂等键冲突"},"422":{"description":"请求字段不符合接口约定"},"429":{"description":"调用过快或达到每日积分上限"},"502":{"description":"内容采集暂时失败"}}}},"/v1/media/douyin-user-profile":{"post":{"summary":"抖音主页资料采集","description":"通过主页分享链接或用户标识获取账号资料。 成功调用消耗 200 积分。","operationId":"collect_douyin_user_profile","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":128},"description":"每个业务请求使用一个永不复用的唯一标识；完成后的响应可在 24 小时内安全重放，不会重复执行或扣费。"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["sec_user_id"],"properties":{"sec_user_id":{"type":"string","description":"平台用户标识","example":"MS4wLjABAAAA_example"}},"example":{"sec_user_id":"MS4wLjABAAAA_example"}},"example":{"sec_user_id":"MS4wLjABAAAA_example"}}}},"responses":{"200":{"description":"采集成功，响应为统一清洗后的字段。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponse"}}}},"400":{"description":"请求参数不正确"},"401":{"description":"API Key 无效或已到期"},"402":{"description":"积分余额不足"},"404":{"description":"接口不存在"},"409":{"description":"幂等键冲突"},"422":{"description":"请求字段不符合接口约定"},"429":{"description":"调用过快或达到每日积分上限"},"502":{"description":"内容采集暂时失败"}}}},"/v1/media/xiaohongshu-image-note-info":{"post":{"summary":"小红书图文笔记采集","description":"通过笔记分享信息获取 App V2 图文笔记详情。 成功调用消耗 200 积分。","operationId":"collect_xiaohongshu_image_note_info","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":128},"description":"每个业务请求使用一个永不复用的唯一标识；完成后的响应可在 24 小时内安全重放，不会重复执行或扣费。"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["note_id"],"properties":{"note_id":{"type":"string","description":"小红书笔记 ID","example":"697c0eee000000000a03c308"}},"example":{"note_id":"697c0eee000000000a03c308"}},"example":{"note_id":"697c0eee000000000a03c308"}}}},"responses":{"200":{"description":"采集成功，响应为统一清洗后的字段。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponse"}}}},"400":{"description":"请求参数不正确"},"401":{"description":"API Key 无效或已到期"},"402":{"description":"积分余额不足"},"404":{"description":"接口不存在"},"409":{"description":"幂等键冲突"},"422":{"description":"请求字段不符合接口约定"},"429":{"description":"调用过快或达到每日积分上限"},"502":{"description":"内容采集暂时失败"}}}},"/v1/media/xiaohongshu-video-note-info":{"post":{"summary":"小红书视频笔记采集","description":"通过笔记分享信息获取 App V2 视频笔记详情。 成功调用消耗 200 积分。","operationId":"collect_xiaohongshu_video_note_info","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":128},"description":"每个业务请求使用一个永不复用的唯一标识；完成后的响应可在 24 小时内安全重放，不会重复执行或扣费。"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["note_id"],"properties":{"note_id":{"type":"string","description":"小红书笔记 ID","example":"697c0eee000000000a03c308"}},"example":{"note_id":"697c0eee000000000a03c308"}},"example":{"note_id":"697c0eee000000000a03c308"}}}},"responses":{"200":{"description":"采集成功，响应为统一清洗后的字段。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponse"}}}},"400":{"description":"请求参数不正确"},"401":{"description":"API Key 无效或已到期"},"402":{"description":"积分余额不足"},"404":{"description":"接口不存在"},"409":{"description":"幂等键冲突"},"422":{"description":"请求字段不符合接口约定"},"429":{"description":"调用过快或达到每日积分上限"},"502":{"description":"内容采集暂时失败"}}}},"/v1/media/xiaohongshu-user-info":{"post":{"summary":"小红书主页资料采集","description":"通过用户标识获取小红书账号资料。 成功调用消耗 200 积分。","operationId":"collect_xiaohongshu_user_info","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":128},"description":"每个业务请求使用一个永不复用的唯一标识；完成后的响应可在 24 小时内安全重放，不会重复执行或扣费。"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["user_id"],"properties":{"user_id":{"type":"string","description":"平台用户 ID","example":"61b46d790000000010008153"}},"example":{"user_id":"61b46d790000000010008153"}},"example":{"user_id":"61b46d790000000010008153"}}}},"responses":{"200":{"description":"采集成功，响应为统一清洗后的字段。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponse"}}}},"400":{"description":"请求参数不正确"},"401":{"description":"API Key 无效或已到期"},"402":{"description":"积分余额不足"},"404":{"description":"接口不存在"},"409":{"description":"幂等键冲突"},"422":{"description":"请求字段不符合接口约定"},"429":{"description":"调用过快或达到每日积分上限"},"502":{"description":"内容采集暂时失败"}}}},"/v1/media/wechat-channels-video-info":{"post":{"summary":"微信视频号单条作品采集","description":"通过 object_id、export_id 或视频号分享链接获取作品详情。 成功调用消耗 200 积分。","operationId":"collect_wechat_channels_video_info","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":128},"description":"每个业务请求使用一个永不复用的唯一标识；完成后的响应可在 24 小时内安全重放，不会重复执行或扣费。"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["object_id"],"properties":{"object_id":{"type":"string","description":"视频号作品 ID","example":"14941130915890399732"},"raw":{"type":"boolean","description":"是否请求原始展示模式，建议 false","example":false}},"example":{"object_id":"14941130915890399732","raw":false}},"example":{"object_id":"14941130915890399732","raw":false}}}},"responses":{"200":{"description":"采集成功，响应为统一清洗后的字段。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponse"}}}},"400":{"description":"请求参数不正确"},"401":{"description":"API Key 无效或已到期"},"402":{"description":"积分余额不足"},"404":{"description":"接口不存在"},"409":{"description":"幂等键冲突"},"422":{"description":"请求字段不符合接口约定"},"429":{"description":"调用过快或达到每日积分上限"},"502":{"description":"内容采集暂时失败"}}}},"/v1/media/wechat-channels-user-videos":{"post":{"summary":"微信视频号主页作品采集","description":"通过 finder username 分页获取视频号主页作品。 成功调用消耗 2000 积分。","operationId":"collect_wechat_channels_user_videos","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":128},"description":"每个业务请求使用一个永不复用的唯一标识；完成后的响应可在 24 小时内安全重放，不会重复执行或扣费。"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["username"],"properties":{"username":{"type":"string","description":"用户名或视频号 finder username","example":"finder_username"},"last_buffer":{"type":"string","description":"视频号分页游标，首页留空","example":""},"raw":{"type":"boolean","description":"是否请求原始展示模式，建议 false","example":false}},"example":{"username":"finder_username","last_buffer":"","raw":false}},"example":{"username":"finder_username","last_buffer":"","raw":false}}}},"responses":{"200":{"description":"采集成功，响应为统一清洗后的字段。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponse"}}}},"400":{"description":"请求参数不正确"},"401":{"description":"API Key 无效或已到期"},"402":{"description":"积分余额不足"},"404":{"description":"接口不存在"},"409":{"description":"幂等键冲突"},"422":{"description":"请求字段不符合接口约定"},"429":{"description":"调用过快或达到每日积分上限"},"502":{"description":"内容采集暂时失败"}}}},"/v1/media/wechat-channels-user-profile":{"post":{"summary":"微信视频号主页资料采集","description":"通过 finder username 获取视频号主页资料和统计。 成功调用消耗 200 积分。","operationId":"collect_wechat_channels_user_profile","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":128},"description":"每个业务请求使用一个永不复用的唯一标识；完成后的响应可在 24 小时内安全重放，不会重复执行或扣费。"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["username"],"properties":{"username":{"type":"string","description":"用户名或视频号 finder username","example":"finder_username"},"raw":{"type":"boolean","description":"是否请求原始展示模式，建议 false","example":false}},"example":{"username":"finder_username","raw":false}},"example":{"username":"finder_username","raw":false}}}},"responses":{"200":{"description":"采集成功，响应为统一清洗后的字段。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponse"}}}},"400":{"description":"请求参数不正确"},"401":{"description":"API Key 无效或已到期"},"402":{"description":"积分余额不足"},"404":{"description":"接口不存在"},"409":{"description":"幂等键冲突"},"422":{"description":"请求字段不符合接口约定"},"429":{"description":"调用过快或达到每日积分上限"},"502":{"description":"内容采集暂时失败"}}}},"/v1/media/wechat-channels-id-resolve":{"post":{"summary":"微信视频号账号标识解析","description":"将视频号 ID 转换为主页采集所需的 finder username。 成功调用消耗 200 积分。","operationId":"collect_wechat_channels_id_resolve","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":128},"description":"每个业务请求使用一个永不复用的唯一标识；完成后的响应可在 24 小时内安全重放，不会重复执行或扣费。"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["channel_id"],"properties":{"channel_id":{"type":"string","description":"频道或视频号 ID","example":"sphi9BjV8GK0Zsl"},"raw":{"type":"boolean","description":"是否请求原始展示模式，建议 false","example":false}},"example":{"channel_id":"sphi9BjV8GK0Zsl","raw":false}},"example":{"channel_id":"sphi9BjV8GK0Zsl","raw":false}}}},"responses":{"200":{"description":"采集成功，响应为统一清洗后的字段。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponse"}}}},"400":{"description":"请求参数不正确"},"401":{"description":"API Key 无效或已到期"},"402":{"description":"积分余额不足"},"404":{"description":"接口不存在"},"409":{"description":"幂等键冲突"},"422":{"description":"请求字段不符合接口约定"},"429":{"description":"调用过快或达到每日积分上限"},"502":{"description":"内容采集暂时失败"}}}},"/v1/media/wechat-channels-channel-info":{"post":{"summary":"微信视频号账号信息采集","description":"获取视频号账号基础信息，供分享链接到主页采集流程使用。 成功调用消耗 200 积分。","operationId":"collect_wechat_channels_channel_info","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":128},"description":"每个业务请求使用一个永不复用的唯一标识；完成后的响应可在 24 小时内安全重放，不会重复执行或扣费。"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["username"],"properties":{"username":{"type":"string","description":"用户名或视频号 finder username","example":"finder_username"},"raw":{"type":"boolean","description":"是否请求原始展示模式，建议 false","example":false}},"example":{"username":"finder_username","raw":false}},"example":{"username":"finder_username","raw":false}}}},"responses":{"200":{"description":"采集成功，响应为统一清洗后的字段。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponse"}}}},"400":{"description":"请求参数不正确"},"401":{"description":"API Key 无效或已到期"},"402":{"description":"积分余额不足"},"404":{"description":"接口不存在"},"409":{"description":"幂等键冲突"},"422":{"description":"请求字段不符合接口约定"},"429":{"description":"调用过快或达到每日积分上限"},"502":{"description":"内容采集暂时失败"}}}},"/v1/media/bilibili-user-videos-full":{"post":{"summary":"B站主页全部投稿采集","description":"通过 UID 获取超过 5000 条后的完整投稿列表，字段较精简。 成功调用消耗 200 积分。","operationId":"collect_bilibili_user_videos_full","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":128},"description":"每个业务请求使用一个永不复用的唯一标识；完成后的响应可在 24 小时内安全重放，不会重复执行或扣费。"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["uid"],"properties":{"uid":{"type":"string","description":"平台用户 UID","example":"178360345"},"pn":{"type":"integer","description":"页码","example":1},"ps":{"type":"integer","description":"每页数量","example":25},"keyword":{"type":"string","description":"请求参数 keyword","example":""}},"example":{"uid":"178360345","pn":1,"ps":25,"keyword":""}},"example":{"uid":"178360345","pn":1,"ps":25,"keyword":""}}}},"responses":{"200":{"description":"采集成功，响应为统一清洗后的字段。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponse"}}}},"400":{"description":"请求参数不正确"},"401":{"description":"API Key 无效或已到期"},"402":{"description":"积分余额不足"},"404":{"description":"接口不存在"},"409":{"description":"幂等键冲突"},"422":{"description":"请求字段不符合接口约定"},"429":{"description":"调用过快或达到每日积分上限"},"502":{"description":"内容采集暂时失败"}}}},"/v1/media/bilibili-user-profile":{"post":{"summary":"B站主页资料采集","description":"通过 UID 获取 B站用户主页资料。 成功调用消耗 200 积分。","operationId":"collect_bilibili_user_profile","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":128},"description":"每个业务请求使用一个永不复用的唯一标识；完成后的响应可在 24 小时内安全重放，不会重复执行或扣费。"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["uid"],"properties":{"uid":{"type":"string","description":"平台用户 UID","example":"178360345"}},"example":{"uid":"178360345"}},"example":{"uid":"178360345"}}}},"responses":{"200":{"description":"采集成功，响应为统一清洗后的字段。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponse"}}}},"400":{"description":"请求参数不正确"},"401":{"description":"API Key 无效或已到期"},"402":{"description":"积分余额不足"},"404":{"description":"接口不存在"},"409":{"description":"幂等键冲突"},"422":{"description":"请求字段不符合接口约定"},"429":{"description":"调用过快或达到每日积分上限"},"502":{"description":"内容采集暂时失败"}}}},"/v1/media/kuaishou-user-profile":{"post":{"summary":"快手主页资料采集","description":"通过用户标识获取快手账号资料。 成功调用消耗 200 积分。","operationId":"collect_kuaishou_user_profile","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":128},"description":"每个业务请求使用一个永不复用的唯一标识；完成后的响应可在 24 小时内安全重放，不会重复执行或扣费。"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["user_id"],"properties":{"user_id":{"type":"string","description":"平台用户 ID","example":"3xz63mn6fngqtiq"}},"example":{"user_id":"3xz63mn6fngqtiq"}},"example":{"user_id":"3xz63mn6fngqtiq"}}}},"responses":{"200":{"description":"采集成功，响应为统一清洗后的字段。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponse"}}}},"400":{"description":"请求参数不正确"},"401":{"description":"API Key 无效或已到期"},"402":{"description":"积分余额不足"},"404":{"description":"接口不存在"},"409":{"description":"幂等键冲突"},"422":{"description":"请求字段不符合接口约定"},"429":{"description":"调用过快或达到每日积分上限"},"502":{"description":"内容采集暂时失败"}}}},"/v1/media/tiktok-user-profile":{"post":{"summary":"TikTok 主页资料采集","description":"通过 TikTok 用户主页信息获取账号资料。 成功调用消耗 200 积分。","operationId":"collect_tiktok_user_profile","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":128},"description":"每个业务请求使用一个永不复用的唯一标识；完成后的响应可在 24 小时内安全重放，不会重复执行或扣费。"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["sec_user_id"],"properties":{"sec_user_id":{"type":"string","description":"平台用户标识","example":"MS4wLjABAAAA_example"}},"example":{"sec_user_id":"MS4wLjABAAAA_example"}},"example":{"sec_user_id":"MS4wLjABAAAA_example"}}}},"responses":{"200":{"description":"采集成功，响应为统一清洗后的字段。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponse"}}}},"400":{"description":"请求参数不正确"},"401":{"description":"API Key 无效或已到期"},"402":{"description":"积分余额不足"},"404":{"description":"接口不存在"},"409":{"description":"幂等键冲突"},"422":{"description":"请求字段不符合接口约定"},"429":{"description":"调用过快或达到每日积分上限"},"502":{"description":"内容采集暂时失败"}}}},"/v1/media/weibo-post-info":{"post":{"summary":"微博单条内容采集","description":"通过微博内容 ID 获取单条微博详情。 成功调用消耗 20 积分。","operationId":"collect_weibo_post_info","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":128},"description":"每个业务请求使用一个永不复用的唯一标识；完成后的响应可在 24 小时内安全重放，不会重复执行或扣费。"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["id"],"properties":{"id":{"type":"string","description":"内容 ID","example":"5092682368025584"},"is_get_long_text":{"type":"boolean","description":"请求参数 is_get_long_text","example":true}},"example":{"id":"5092682368025584","is_get_long_text":true}},"example":{"id":"5092682368025584","is_get_long_text":true}}}},"responses":{"200":{"description":"采集成功，响应为统一清洗后的字段。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponse"}}}},"400":{"description":"请求参数不正确"},"401":{"description":"API Key 无效或已到期"},"402":{"description":"积分余额不足"},"404":{"description":"接口不存在"},"409":{"description":"幂等键冲突"},"422":{"description":"请求字段不符合接口约定"},"429":{"description":"调用过快或达到每日积分上限"},"502":{"description":"内容采集暂时失败"}}}},"/v1/media/weibo-user-posts":{"post":{"summary":"微博主页内容采集","description":"通过 UID 分页获取用户主页发布内容。 成功调用消耗 200 积分。","operationId":"collect_weibo_user_posts","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":128},"description":"每个业务请求使用一个永不复用的唯一标识；完成后的响应可在 24 小时内安全重放，不会重复执行或扣费。"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["uid"],"properties":{"uid":{"type":"string","description":"平台用户 UID","example":"7277477906"},"page":{"type":"integer","description":"页码","example":1},"feature":{"type":"integer","description":"请求参数 feature","example":0},"since_id":{"type":"string","description":"请求参数 since_id","example":""}},"example":{"uid":"7277477906","page":1,"feature":0,"since_id":""}},"example":{"uid":"7277477906","page":1,"feature":0,"since_id":""}}}},"responses":{"200":{"description":"采集成功，响应为统一清洗后的字段。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponse"}}}},"400":{"description":"请求参数不正确"},"401":{"description":"API Key 无效或已到期"},"402":{"description":"积分余额不足"},"404":{"description":"接口不存在"},"409":{"description":"幂等键冲突"},"422":{"description":"请求字段不符合接口约定"},"429":{"description":"调用过快或达到每日积分上限"},"502":{"description":"内容采集暂时失败"}}}},"/v1/media/weibo-user-profile":{"post":{"summary":"微博主页资料采集","description":"通过 UID 获取微博账号资料。 成功调用消耗 200 积分。","operationId":"collect_weibo_user_profile","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":128},"description":"每个业务请求使用一个永不复用的唯一标识；完成后的响应可在 24 小时内安全重放，不会重复执行或扣费。"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["uid"],"properties":{"uid":{"type":"string","description":"平台用户 UID","example":"1722594714"}},"example":{"uid":"1722594714"}},"example":{"uid":"1722594714"}}}},"responses":{"200":{"description":"采集成功，响应为统一清洗后的字段。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponse"}}}},"400":{"description":"请求参数不正确"},"401":{"description":"API Key 无效或已到期"},"402":{"description":"积分余额不足"},"404":{"description":"接口不存在"},"409":{"description":"幂等键冲突"},"422":{"description":"请求字段不符合接口约定"},"429":{"description":"调用过快或达到每日积分上限"},"502":{"description":"内容采集暂时失败"}}}},"/v1/media/youtube-video-info":{"post":{"summary":"YouTube 单条视频采集","description":"通过视频 ID 或链接获取 YouTube 视频详情。 成功调用消耗 20 积分。","operationId":"collect_youtube_video_info","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":128},"description":"每个业务请求使用一个永不复用的唯一标识；完成后的响应可在 24 小时内安全重放，不会重复执行或扣费。"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["video_id"],"properties":{"video_id":{"type":"string","description":"视频 ID","example":"dQw4w9WgXcQ"},"need_format":{"type":"boolean","description":"请求参数 need_format","example":true},"language_code":{"type":"string","description":"请求参数 language_code","example":"zh-CN"}},"example":{"video_id":"dQw4w9WgXcQ","need_format":true,"language_code":"zh-CN"}},"example":{"video_id":"dQw4w9WgXcQ","need_format":true,"language_code":"zh-CN"}}}},"responses":{"200":{"description":"采集成功，响应为统一清洗后的字段。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponse"}}}},"400":{"description":"请求参数不正确"},"401":{"description":"API Key 无效或已到期"},"402":{"description":"积分余额不足"},"404":{"description":"接口不存在"},"409":{"description":"幂等键冲突"},"422":{"description":"请求字段不符合接口约定"},"429":{"description":"调用过快或达到每日积分上限"},"502":{"description":"内容采集暂时失败"}}}},"/v1/media/youtube-channel-videos":{"post":{"summary":"YouTube 频道视频采集","description":"通过频道 ID 和 continuation token 分页获取频道视频。 成功调用消耗 200 积分。","operationId":"collect_youtube_channel_videos","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":128},"description":"每个业务请求使用一个永不复用的唯一标识；完成后的响应可在 24 小时内安全重放，不会重复执行或扣费。"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["channel_id"],"properties":{"channel_id":{"type":"string","description":"频道或视频号 ID","example":"UCJHBJ7F-nAIlMGolm0Hu4vg"},"language_code":{"type":"string","description":"请求参数 language_code","example":"zh-CN"},"country_code":{"type":"string","description":"请求参数 country_code","example":"US"},"need_format":{"type":"boolean","description":"请求参数 need_format","example":true}},"example":{"channel_id":"UCJHBJ7F-nAIlMGolm0Hu4vg","language_code":"zh-CN","country_code":"US","need_format":true}},"example":{"channel_id":"UCJHBJ7F-nAIlMGolm0Hu4vg","language_code":"zh-CN","country_code":"US","need_format":true}}}},"responses":{"200":{"description":"采集成功，响应为统一清洗后的字段。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponse"}}}},"400":{"description":"请求参数不正确"},"401":{"description":"API Key 无效或已到期"},"402":{"description":"积分余额不足"},"404":{"description":"接口不存在"},"409":{"description":"幂等键冲突"},"422":{"description":"请求字段不符合接口约定"},"429":{"description":"调用过快或达到每日积分上限"},"502":{"description":"内容采集暂时失败"}}}},"/v1/media/youtube-channel-info":{"post":{"summary":"YouTube 频道资料采集","description":"通过频道标识获取 YouTube 频道资料。 成功调用消耗 200 积分。","operationId":"collect_youtube_channel_info","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":128},"description":"每个业务请求使用一个永不复用的唯一标识；完成后的响应可在 24 小时内安全重放，不会重复执行或扣费。"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["channel_id"],"properties":{"channel_id":{"type":"string","description":"频道或视频号 ID","example":"UCXuqSBlHAE6Xw-yeJA0Tunw"}},"example":{"channel_id":"UCXuqSBlHAE6Xw-yeJA0Tunw"}},"example":{"channel_id":"UCXuqSBlHAE6Xw-yeJA0Tunw"}}}},"responses":{"200":{"description":"采集成功，响应为统一清洗后的字段。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponse"}}}},"400":{"description":"请求参数不正确"},"401":{"description":"API Key 无效或已到期"},"402":{"description":"积分余额不足"},"404":{"description":"接口不存在"},"409":{"description":"幂等键冲突"},"422":{"description":"请求字段不符合接口约定"},"429":{"description":"调用过快或达到每日积分上限"},"502":{"description":"内容采集暂时失败"}}}},"/v1/media/instagram-post-info":{"post":{"summary":"Instagram 单条帖子采集","description":"通过帖子链接获取单条帖子详情。 成功调用消耗 20 积分。","operationId":"collect_instagram_post_info","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":128},"description":"每个业务请求使用一个永不复用的唯一标识；完成后的响应可在 24 小时内安全重放，不会重复执行或扣费。"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["post_url"],"properties":{"post_url":{"type":"string","description":"帖子链接","example":"https://www.instagram.com/p/DPwhVB-jo9k/"}},"example":{"post_url":"https://www.instagram.com/p/DPwhVB-jo9k/"}},"example":{"post_url":"https://www.instagram.com/p/DPwhVB-jo9k/"}}}},"responses":{"200":{"description":"采集成功，响应为统一清洗后的字段。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponse"}}}},"400":{"description":"请求参数不正确"},"401":{"description":"API Key 无效或已到期"},"402":{"description":"积分余额不足"},"404":{"description":"接口不存在"},"409":{"description":"幂等键冲突"},"422":{"description":"请求字段不符合接口约定"},"429":{"description":"调用过快或达到每日积分上限"},"502":{"description":"内容采集暂时失败"}}}},"/v1/media/instagram-user-posts":{"post":{"summary":"Instagram 主页帖子采集","description":"通过用户 ID 分页获取主页帖子。 成功调用消耗 200 积分。","operationId":"collect_instagram_user_posts","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":128},"description":"每个业务请求使用一个永不复用的唯一标识；完成后的响应可在 24 小时内安全重放，不会重复执行或扣费。"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["user_id"],"properties":{"user_id":{"type":"string","description":"平台用户 ID","example":"25025320"},"count":{"type":"integer","description":"返回数量","example":12}},"example":{"user_id":"25025320","count":12}},"example":{"user_id":"25025320","count":12}}}},"responses":{"200":{"description":"采集成功，响应为统一清洗后的字段。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponse"}}}},"400":{"description":"请求参数不正确"},"401":{"description":"API Key 无效或已到期"},"402":{"description":"积分余额不足"},"404":{"description":"接口不存在"},"409":{"description":"幂等键冲突"},"422":{"description":"请求字段不符合接口约定"},"429":{"description":"调用过快或达到每日积分上限"},"502":{"description":"内容采集暂时失败"}}}},"/v1/media/instagram-user-profile":{"post":{"summary":"Instagram 主页资料采集","description":"通过用户名获取 Instagram 账号资料和用户 ID。 成功调用消耗 200 积分。","operationId":"collect_instagram_user_profile","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":128},"description":"每个业务请求使用一个永不复用的唯一标识；完成后的响应可在 24 小时内安全重放，不会重复执行或扣费。"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["username"],"properties":{"username":{"type":"string","description":"用户名或视频号 finder username","example":"instagram"}},"example":{"username":"instagram"}},"example":{"username":"instagram"}}}},"responses":{"200":{"description":"采集成功，响应为统一清洗后的字段。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponse"}}}},"400":{"description":"请求参数不正确"},"401":{"description":"API Key 无效或已到期"},"402":{"description":"积分余额不足"},"404":{"description":"接口不存在"},"409":{"description":"幂等键冲突"},"422":{"description":"请求字段不符合接口约定"},"429":{"description":"调用过快或达到每日积分上限"},"502":{"description":"内容采集暂时失败"}}}},"/v1/media/xigua-video-info":{"post":{"summary":"西瓜视频单条作品采集","description":"通过作品标识获取西瓜视频单条作品详情。 成功调用消耗 20 积分。","operationId":"collect_xigua_video_info","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":128},"description":"每个业务请求使用一个永不复用的唯一标识；完成后的响应可在 24 小时内安全重放，不会重复执行或扣费。"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["item_id"],"properties":{"item_id":{"type":"string","description":"作品 ID","example":"7354954305222377999"}},"example":{"item_id":"7354954305222377999"}},"example":{"item_id":"7354954305222377999"}}}},"responses":{"200":{"description":"采集成功，响应为统一清洗后的字段。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponse"}}}},"400":{"description":"请求参数不正确"},"401":{"description":"API Key 无效或已到期"},"402":{"description":"积分余额不足"},"404":{"description":"接口不存在"},"409":{"description":"幂等键冲突"},"422":{"description":"请求字段不符合接口约定"},"429":{"description":"调用过快或达到每日积分上限"},"502":{"description":"内容采集暂时失败"}}}},"/v1/media/xigua-user-posts":{"post":{"summary":"西瓜视频主页作品采集","description":"通过用户标识分页获取西瓜视频主页作品。 成功调用消耗 200 积分。","operationId":"collect_xigua_user_posts","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":128},"description":"每个业务请求使用一个永不复用的唯一标识；完成后的响应可在 24 小时内安全重放，不会重复执行或扣费。"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["user_id"],"properties":{"user_id":{"type":"string","description":"平台用户 ID","example":"1922379661976311"}},"example":{"user_id":"1922379661976311"}},"example":{"user_id":"1922379661976311"}}}},"responses":{"200":{"description":"采集成功，响应为统一清洗后的字段。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponse"}}}},"400":{"description":"请求参数不正确"},"401":{"description":"API Key 无效或已到期"},"402":{"description":"积分余额不足"},"404":{"description":"接口不存在"},"409":{"description":"幂等键冲突"},"422":{"description":"请求字段不符合接口约定"},"429":{"description":"调用过快或达到每日积分上限"},"502":{"description":"内容采集暂时失败"}}}},"/v1/media/xigua-user-profile":{"post":{"summary":"西瓜视频主页资料采集","description":"通过用户标识获取西瓜视频账号资料。 成功调用消耗 200 积分。","operationId":"collect_xigua_user_profile","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":128},"description":"每个业务请求使用一个永不复用的唯一标识；完成后的响应可在 24 小时内安全重放，不会重复执行或扣费。"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["user_id"],"properties":{"user_id":{"type":"string","description":"平台用户 ID","example":"52712347586"}},"example":{"user_id":"52712347586"}},"example":{"user_id":"52712347586"}}}},"responses":{"200":{"description":"采集成功，响应为统一清洗后的字段。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponse"}}}},"400":{"description":"请求参数不正确"},"401":{"description":"API Key 无效或已到期"},"402":{"description":"积分余额不足"},"404":{"description":"接口不存在"},"409":{"description":"幂等键冲突"},"422":{"description":"请求字段不符合接口约定"},"429":{"description":"调用过快或达到每日积分上限"},"502":{"description":"内容采集暂时失败"}}}}}}