{ "openapi": "3.1.0", "info": { "title": "Qovia API", "version": "0.1.0", "summary": "Public web data API for AI: 165 endpoints, one key, one JSON envelope.", "description": "Public web data for AI agents and developers: social, e-commerce and web platforms behind one API key and one JSON envelope.\n\n- **Base URL:** `https://api.qovia.ai`\n- **Auth:** `Authorization: Bearer ` (or `x-api-key: `). Create keys at https://qovia.ai/console/?tab=keys.\n- **Requests:** GET endpoints take query parameters, POST endpoints a JSON object body. Unknown parameters are rejected with 400 `invalid_params`.\n- **Responses:** HTTP 200 with `{\"request_id\", \"data\", \"meta\"}`. An empty result is still 200, with `meta.empty: true` and `data` empty or null. Errors are `{\"error\": {\"code\", \"message\", \"request_id\", \"support\"}}`; branch on `code`.\n- **Billing (USD):** a new account gets 50 trial calls on any endpoint (`meta.trial_calls_remaining` counts down); after that, a prepaid balance. Only successful, non-empty results are charged or counted, and errors and empty results are not.\n- **Rate limits:** none. Qovia does not limit requests per minute per account or per endpoint; only repeated failed authentication from one IP is throttled (429 `too_many_auth_failures`). Honour `Retry-After` if a 429 or 503 carries it.\n- `/v1` only takes GET and POST: other methods (e.g. PUT, DELETE) get a framework 405 `{\"detail\": \"Method Not Allowed\"}`, and an unexpected server error may be a plain-text 500. Neither is charged.\n\nDocs: https://qovia.ai/docs/ · API reference: https://qovia.ai/docs/api-reference/ · Chinese: https://qovia.ai/zh/docs/" }, "servers": [ { "url": "https://api.qovia.ai" } ], "security": [ { "bearerAuth": [] }, { "apiKeyHeader": [] } ], "tags": [ { "name": "Search", "x-qovia-group": "search", "x-qovia-name-zh": "跨域检索" }, { "name": "Douyin", "x-qovia-group": "douyin", "x-qovia-name-zh": "抖音" }, { "name": "Kuaishou", "x-qovia-group": "kuaishou", "x-qovia-name-zh": "快手" }, { "name": "Bilibili", "x-qovia-group": "bilibili", "x-qovia-name-zh": "B 站" }, { "name": "Douyin Xingtu", "x-qovia-group": "xingtu", "x-qovia-name-zh": "抖音星图" }, { "name": "Tieba", "x-qovia-group": "tieba", "x-qovia-name-zh": "贴吧" }, { "name": "Zhihu", "x-qovia-group": "zhihu", "x-qovia-name-zh": "知乎" }, { "name": "WeChat Official Accounts & Channels", "x-qovia-group": "wechat", "x-qovia-name-zh": "微信公众号与视频号" }, { "name": "Xiaohongshu (RedNote)", "x-qovia-group": "xiaohongshu", "x-qovia-name-zh": "小红书" }, { "name": "Xiaohongshu Pugongying", "x-qovia-group": "pgy", "x-qovia-name-zh": "小红书蒲公英" }, { "name": "TikTok", "x-qovia-group": "tiktok", "x-qovia-name-zh": "TikTok" }, { "name": "YouTube", "x-qovia-group": "youtube", "x-qovia-name-zh": "YouTube" }, { "name": "Instagram", "x-qovia-group": "instagram", "x-qovia-name-zh": "Instagram" }, { "name": "X (Twitter)", "x-qovia-group": "x", "x-qovia-name-zh": "X（Twitter）" }, { "name": "Reddit", "x-qovia-group": "reddit", "x-qovia-name-zh": "Reddit" }, { "name": "Weibo", "x-qovia-group": "weibo", "x-qovia-name-zh": "微博" }, { "name": "Toutiao", "x-qovia-group": "toutiao", "x-qovia-name-zh": "今日头条" }, { "name": "Taobao & Tmall", "x-qovia-group": "taobao", "x-qovia-name-zh": "淘宝与天猫" }, { "name": "JD.com", "x-qovia-group": "jd", "x-qovia-name-zh": "京东" }, { "name": "Shopee", "x-qovia-group": "shopee", "x-qovia-name-zh": "Shopee" }, { "name": "Amazon", "x-qovia-group": "amazon", "x-qovia-name-zh": "Amazon" }, { "name": "Fliggy", "x-qovia-group": "fliggy", "x-qovia-name-zh": "飞猪" }, { "name": "News", "x-qovia-group": "news", "x-qovia-name-zh": "全球新闻" }, { "name": "Cili Juxing", "x-qovia-group": "cljx", "x-qovia-name-zh": "磁力聚星" }, { "name": "Huahuo", "x-qovia-group": "huahuo", "x-qovia-name-zh": "花火" }, { "name": "Account" } ], "paths": { "/v1/search": { "post": { "operationId": "search", "summary": "Cross-domain search", "description": "One search across 10 kinds of public sources in China (Weibo, Douyin, Toutiao, Xiaohongshu, Kuaishou and other short-video apps, WeChat official accounts, news sites and newspapers, forums and Tieba, Bilibili and other long-video sites, news apps), filtered by date, platform, content type and sentiment. Returns the results in one format, with the total hit count and the count per platform. Dates are whole days in Beijing time: the last 7 days by default, at most 90. 10 or 20 results per page, up to page 50. A search usually takes a few seconds. No results answers empty and is not charged.", "tags": [ "Search" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "query" ], "additionalProperties": false, "properties": { "query": { "type": "string", "minLength": 1, "maxLength": 200, "pattern": "\\S", "description": "What to search for. Separate terms with spaces to require all of them, as in 人工智能 教育; put words to leave out in exclude_words", "x-qovia-description-zh": "搜索词。多个词用空格分开，表示同时包含，如「人工智能 教育」；要排除的词放进 exclude_words", "examples": [ "人工智能" ] }, "platforms": { "type": "array", "items": { "type": "string", "enum": [ "weibo", "douyin", "toutiao", "xiaohongshu", "short_video", "wechat", "news", "forum", "long_video", "app" ] }, "minItems": 1, "maxItems": 10, "uniqueItems": true, "default": [ "weibo", "douyin", "toutiao", "xiaohongshu", "short_video", "wechat", "news", "forum", "long_video", "app" ], "description": "Only these platforms, all by default: weibo, douyin, toutiao, xiaohongshu, short_video (Kuaishou and other short-video apps), wechat (official accounts), news (news sites and newspapers), forum (forums, Tieba and Q&A sites), long_video (Bilibili and other long-video sites), app (news apps)", "x-qovia-description-zh": "只搜这些平台，默认全部：weibo 微博、douyin 抖音、toutiao 今日头条、xiaohongshu 小红书、short_video 快手等短视频、wechat 微信公众号、news 新闻网站与纸媒、forum 论坛贴吧与问答、long_video B 站等长视频、app 新闻 APP" }, "since": { "type": "string", "format": "date", "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$", "description": "First day, YYYY-MM-DD (Beijing time, included); defaults to 6 days before until", "x-qovia-description-zh": "起始日期 YYYY-MM-DD（北京时间，含当天），默认 until 往前 6 天" }, "until": { "type": "string", "format": "date", "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$", "description": "Last day, YYYY-MM-DD (Beijing time, included); defaults to today and cannot be later. since to until spans at most 90 days", "x-qovia-description-zh": "截止日期 YYYY-MM-DD（北京时间，含当天），默认今天，不能晚于今天；since 到 until 最多 90 天" }, "types": { "type": "array", "items": { "type": "string", "enum": [ "original", "repost", "comment" ] }, "minItems": 1, "maxItems": 3, "uniqueItems": true, "default": [ "original", "repost", "comment" ], "description": "Content types, all by default: original, repost, comment", "x-qovia-description-zh": "内容类型，默认全部：original 原创、repost 转发、comment 评论" }, "sentiment": { "type": "array", "items": { "type": "string", "enum": [ "negative", "neutral", "positive" ] }, "minItems": 1, "maxItems": 3, "uniqueItems": true, "default": [ "negative", "neutral", "positive" ], "description": "Sentiment, all by default: negative, neutral, positive", "x-qovia-description-zh": "情感倾向，默认全部：negative 负面、neutral 中性、positive 正面" }, "match": { "type": "array", "items": { "type": "string", "enum": [ "title", "content", "author", "media_text", "audio" ] }, "minItems": 1, "maxItems": 5, "uniqueItems": true, "default": [ "title", "content", "author" ], "description": "Where the search terms must match, title, content and author by default: title, content, author (author name), media_text (images and video frames), audio", "x-qovia-description-zh": "在哪里匹配搜索词，默认标题、正文和作者：title 标题、content 正文、author 作者名、media_text 图片和视频画面、audio 音频" }, "exclude_words": { "type": "string", "maxLength": 100, "description": "Filter words; results that contain them are left out", "x-qovia-description-zh": "过滤词：含这些词的结果不返回" }, "author": { "type": "string", "maxLength": 50, "description": "Only content published by this author (account name)", "x-qovia-description-zh": "只看这个作者（账号名称）发布的内容" }, "page": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1, "description": "Page number, from 1, at most 50", "x-qovia-description-zh": "页码，从 1 开始，最大 50" }, "limit": { "type": "integer", "enum": [ 10, 20 ], "default": 20, "description": "Results per page: 10 or 20", "x-qovia-description-zh": "每页条数：10 或 20" } } }, "example": { "query": "人工智能" } } } }, "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "id": "soc_wei_e32e9c5a0c8f", "platform": "weibo", "site": "微博", "title": "“‘念PPT’其背后折射出的更多是教学态度、教学效果和课堂互动方面的问题。”中国教育发展战略学会人工智能与机器人...", "original_title": null, "text": "“‘念PPT’其背后折射出的更多是教学态度、教学效果和课堂互动方面的问题。”中国教育发展战略学会人工智能与机器人教育专业…", "summary": null, "url": "http://weibo.com/1700648435/RnISydWJo", "published_at": "2026-10-21T19:31:06+08:00", "type": "original", "sentiment": "neutral", "author": { "name": "成都商报", "followers": 25329072, "following": 947, "description": "《成都商报》是西部地区发行量和影响力最大的主流媒体。互联网新闻信息服务许可证：51120180004。", "avatar": "https://tvax3.sinaimg.cn/crop.0.0.1000.1000.50/001R5Kltly8h8vghc7zenj60rs0rsjsz02.jpg?KID=imgbed,tva&Expires=1792593090&ssig=E8HZxs%2Frbc" }, "ip_location": null, "location": "四川", "media": { "images": [], "videos": [ "http://weibo.com/1700648435/RnISydWJo" ] }, "repost_of": null, "metrics": { "likes": null, "comments": null, "shares": null, "views": 324, "saves": null } }, { "id": "web_new_bf22c963ec0e", "platform": "news", "site": "懂车帝", "title": "*ST易录：2026年第三季度净利润亏损1.54亿元", "original_title": null, "text": "同花顺各类信息服务基于人工智能算法，如有出入请以证监会指定上市公司信息披露平台为准。如有投资者据此操作，风险自担，同花顺…", "summary": null, "url": "https://www.dongchedi.com/article/7699080505556107818/", "published_at": "2026-10-21T19:24:45+08:00", "type": "original", "sentiment": "negative", "author": { "name": "同花顺财经", "followers": 1334032, "following": 22, "description": "股票金融信息资讯专家", "avatar": "https://sf3-cdn-tos.toutiaostatic.com/img/user-avatar/2x_16286e5ac29b80d8e23428a6d5b72b9e~1080x1080.image" }, "ip_location": "北京", "location": null, "media": { "images": [], "videos": [] }, "repost_of": null, "metrics": null } ], "total": 1966273, "by_platform": { "weibo": 119048, "douyin": 380189, "toutiao": 364539, "xiaohongshu": 52024, "short_video": 16111, "wechat": 234572, "news": 589995, "forum": 26994, "long_video": 9314, "app": 173500 }, "page": 1, "limit": 20, "has_more": true, "prov": { "hash": "0xb0ecb783f9c747ec", "ts": "2026-10-21T19:35:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.005000", "balance_usd": "9.995000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "search", "x-qovia-title-zh": "跨域检索", "x-qovia-description-zh": "一次搜索国内 10 类公开信源（微博、抖音、今日头条、小红书、快手等短视频、微信公众号、新闻网站与纸媒、论坛贴吧、B 站等长视频、新闻 APP），可按时间、平台、内容类型和情感筛选，返回统一格式的结果、命中总数和各平台分布。时间按北京时间的自然日计算，默认最近 7 天，最多 90 天。每页 10 或 20 条，最多翻到第 50 页。一次搜索通常需要几秒钟。没有结果时返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "search", "x-qovia-price": { "mode": "tiered", "unit_price_micros": 5000, "usd_per_call": "0.005000", "usd_per_1k": "5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/search/" } }, "/v1/raw/douyin/video": { "get": { "operationId": "raw_douyin_video", "summary": "Douyin video detail", "description": "Metadata and engagement metrics for one video.", "tags": [ "Douyin" ], "parameters": [ { "name": "item_id", "in": "query", "required": true, "description": "Video ID (aweme_id)", "x-qovia-description-zh": "作品 ID（aweme_id）", "schema": { "type": "string", "pattern": "^[0-9]{15,20}$", "examples": [ "7681194457378688292" ] }, "example": "7681194457378688292" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "id": "soc_dou_3f9a1c27b0e4", "src": "social", "platform": "douyin", "lang": "zh-CN", "text": "新能源车续航实测，冬天打几折…", "author": { "uid_hash": "a19c04e7d2b3", "followers": 482100, "nickname": "车评老王", "uid": "108800000001", "sec_uid": "MS4wLjABAAAAexampleCreatorSecUid0000000000000001", "unique_id": "chepinglaowang" }, "metrics": { "likes": 120384, "comments": 8217, "shares": 5093, "saves": 14022, "plays": 2310000 }, "extra": { "video_dur_s": 47, "topic": "#新能源", "source_id": "7681000000000000001", "published_at": "2026-10-18T19:30:55+08:00", "topics": [ "新能源", "冬季续航" ], "content_type": "video", "cover_url": "https://p3-sign.douyinpic.com/tos-cn-i-0813/example~tplv-dy-resize-origshort-autoq-75:330.jpeg", "url": "https://www.douyin.com/video/7681000000000000001" }, "prov": { "hash": "0x527bcbac1d09e4f6", "ts": "2026-10-20T09:12:41+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.000500", "balance_usd": "9.999500", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.douyin.video", "x-qovia-title-zh": "抖音作品详情", "x-qovia-description-zh": "单个作品的元数据和互动数据（播放、点赞、评论、分享、收藏）。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:douyin", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 500, "usd_per_call": "0.000500", "usd_per_1k": "0.5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.douyin.video/" } }, "/v1/raw/douyin/comments": { "get": { "operationId": "raw_douyin_comments", "summary": "Douyin video comments", "description": "Comment tree for a video, cursor-paginated, up to 50 per page.", "tags": [ "Douyin" ], "parameters": [ { "name": "item_id", "in": "query", "required": true, "description": "Video ID (aweme_id)", "x-qovia-description-zh": "作品 ID（aweme_id）", "schema": { "type": "string", "pattern": "^[0-9]{15,20}$", "examples": [ "7681194457378688292" ] }, "example": "7681194457378688292" }, { "name": "cursor", "in": "query", "required": false, "description": "The cursor from the previous page's response. Douyin may reorder between pages, so adjacent pages can overlap; deduplicate by cid", "x-qovia-description-zh": "取上一页响应的 cursor。抖音每页排序可能变化，相邻页可能有重复，请按 cid 去重", "schema": { "type": "integer", "minimum": 0, "default": 0 } }, { "name": "count", "in": "query", "required": false, "description": "Items per page", "x-qovia-description-zh": "每页条数", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 20 } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "cid": "7688288247533732657", "text": "电池衰减才是关键", "likes": 932, "ip_location": "北京", "reply_count": 41, "created_at": "2026-10-18T21:04:17+08:00", "is_hot": true, "images": [], "author": { "uid_hash": "5be1f0a9c3d7", "nickname": "夜跑的阿杰", "uid": "93100000001", "sec_uid": "MS4wLjABAAAAexampleCommenterSecUid00000000001", "unique_id": "yepao_ajie" } }, { "cid": "7688301125409981234", "text": "北方实测来了…", "likes": 517, "ip_location": "黑龙江", "reply_count": 12, "created_at": "2026-10-18T22:41:09+08:00", "is_hot": false, "images": [], "author": { "uid_hash": "0c7d2e94b1fa", "nickname": "哈尔滨老司机", "uid": "93100000002", "sec_uid": "MS4wLjABAAAAexampleCommenterSecUid00000000002", "unique_id": null } } ], "cursor": 20, "has_more": true, "total": 2513, "prov": { "hash": "0x9e2b47c01a6f3d58", "ts": "2026-10-20T12:11:16+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.000500", "balance_usd": "9.999500", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.douyin.comments", "x-qovia-title-zh": "抖音作品评论", "x-qovia-description-zh": "作品的评论树，按游标翻页，每页最多 50 条。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:douyin", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 500, "usd_per_call": "0.000500", "usd_per_1k": "0.5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.douyin.comments/" } }, "/v1/raw/douyin/creator": { "get": { "operationId": "raw_douyin_creator", "summary": "Douyin creator profile", "description": "Creator profile with followers, likes, post count and verification.", "tags": [ "Douyin" ], "parameters": [ { "name": "user_id", "in": "query", "required": true, "description": "The user's sec_uid (starts with MS4wLjABAAAA; Douyin rejects numeric uids)", "x-qovia-description-zh": "用户 sec_uid（MS4wLjABAAAA 开头；数字 uid 会被抖音拒绝）", "schema": { "type": "string", "pattern": "^MS4wLjABAAAA[0-9A-Za-z_-]{20,100}$", "examples": [ "MS4wLjABAAAAAKgMNYSx2pL3ARundki9oB8pmdvX9hVgujii5bnZUXs" ] }, "example": "MS4wLjABAAAAAKgMNYSx2pL3ARundki9oB8pmdvX9hVgujii5bnZUXs" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "uid_hash": "a19c04e7d2b3", "nickname": "车评老王", "followers": 482100, "total_likes": 9820311, "posts": 612, "verified": true, "platform": "douyin", "uid": "108800000001", "sec_uid": "MS4wLjABAAAAexampleCreatorSecUid0000000000000001", "unique_id": "chepinglaowang", "following": 357, "signature": "十年汽车媒体人，只说真话。", "ip_location": "北京", "verify_reason": "汽车自媒体", "avatar_url": "https://p3-pc.douyinpic.com/aweme/1080x1080/aweme-avatar/example.jpeg", "url": "https://www.douyin.com/user/MS4wLjABAAAAexampleCreatorSecUid0000000000000001", "prov": { "hash": "0x0d6c51e3a8b2f497", "ts": "2026-10-20T12:11:38+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.000500", "balance_usd": "9.999500", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.douyin.creator", "x-qovia-title-zh": "抖音创作者资料", "x-qovia-description-zh": "创作者主页资料：粉丝、获赞、作品数、认证信息。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:douyin", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 500, "usd_per_call": "0.000500", "usd_per_1k": "0.5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.douyin.creator/" } }, "/v1/raw/douyin/comment_replies": { "get": { "operationId": "raw_douyin_comment_replies", "summary": "Douyin comment replies", "description": "Replies under one comment, cursor-paginated, up to 50 per page, with reply target, IP region and likes.", "tags": [ "Douyin" ], "parameters": [ { "name": "item_id", "in": "query", "required": true, "description": "Video ID (aweme_id)", "x-qovia-description-zh": "作品 ID（aweme_id）", "schema": { "type": "string", "pattern": "^[0-9]{15,20}$", "examples": [ "7681194457378688292" ] }, "example": "7681194457378688292" }, { "name": "comment_id", "in": "query", "required": true, "description": "Parent comment cid (from the video comments endpoint)", "x-qovia-description-zh": "父评论 cid（来自作品评论接口）", "schema": { "type": "string", "pattern": "^[0-9]{15,20}$", "examples": [ "7682268648353825585" ] }, "example": "7682268648353825585" }, { "name": "cursor", "in": "query", "required": false, "description": "The cursor from the previous page's response", "x-qovia-description-zh": "取上一页响应的 cursor", "schema": { "type": "integer", "minimum": 0, "default": 0 } }, { "name": "count", "in": "query", "required": false, "description": "Items per page", "x-qovia-description-zh": "每页条数", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 20 } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "cid": "7683888192056476475", "text": "同意，三年后的残值更关键", "likes": 214, "ip_location": "江苏", "reply_count": null, "created_at": "2026-10-12T08:15:40+08:00", "is_hot": false, "images": [], "author": { "uid_hash": "7a40c2e18d5b", "nickname": "南京车友小周", "uid": "93100000003", "sec_uid": "MS4wLjABAAAAexampleCommenterSecUid00000000003", "unique_id": null }, "parent_cid": "7682268648353825585", "reply_to_cid": null } ], "cursor": 10, "has_more": true, "total": 323, "prov": { "hash": "0x41d8a0e6b72c95f3", "ts": "2026-10-20T12:11:31+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.000500", "balance_usd": "9.999500", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.douyin.comment_replies", "x-qovia-title-zh": "抖音评论回复", "x-qovia-description-zh": "某条评论下的回复（楼中楼），按游标翻页，每页最多 50 条，含回复对象、IP 属地和点赞数。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:douyin", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 500, "usd_per_call": "0.000500", "usd_per_1k": "0.5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.douyin.comment_replies/" } }, "/v1/raw/douyin/search": { "get": { "operationId": "raw_douyin_search", "summary": "Douyin search", "description": "Keyword search over videos and image posts as unified records (same ids as video detail); pass the previous cursor and search_id to page. Some parameters depend on each other; see x-qovia-params-schema.", "tags": [ "Douyin" ], "parameters": [ { "name": "keyword", "in": "query", "required": true, "description": "Search keyword", "x-qovia-description-zh": "搜索关键词", "schema": { "type": "string", "minLength": 1, "maxLength": 100, "examples": [ "新能源汽车" ] }, "example": "新能源汽车" }, { "name": "cursor", "in": "query", "required": false, "description": "The cursor from the previous page's response", "x-qovia-description-zh": "取上一页响应的 cursor", "schema": { "type": "integer", "minimum": 0, "maximum": 1000, "default": 0 } }, { "name": "search_id", "in": "query", "required": false, "description": "The search_id from the previous page's response; required when cursor is above 0", "x-qovia-description-zh": "取上一页响应的 search_id；cursor 大于 0 时必填", "schema": { "type": "string", "pattern": "^[0-9A-Za-z]{10,64}$" } }, { "name": "count", "in": "query", "required": false, "description": "Items per page", "x-qovia-description-zh": "每页条数", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 10 } } ], "x-qovia-params-schema": { "type": "object", "required": [ "keyword" ], "additionalProperties": false, "properties": { "keyword": { "type": "string", "minLength": 1, "maxLength": 100, "description": "Search keyword", "x-qovia-description-zh": "搜索关键词", "examples": [ "新能源汽车" ] }, "cursor": { "type": "integer", "minimum": 0, "maximum": 1000, "default": 0, "description": "The cursor from the previous page's response", "x-qovia-description-zh": "取上一页响应的 cursor" }, "search_id": { "type": "string", "pattern": "^[0-9A-Za-z]{10,64}$", "description": "The search_id from the previous page's response; required when cursor is above 0", "x-qovia-description-zh": "取上一页响应的 search_id；cursor 大于 0 时必填" }, "count": { "type": "integer", "minimum": 1, "maximum": 50, "default": 10, "description": "Items per page", "x-qovia-description-zh": "每页条数" } }, "if": { "required": [ "cursor" ], "properties": { "cursor": { "exclusiveMinimum": 0 } } }, "then": { "required": [ "search_id" ] } }, "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "id": "soc_dou_3f9a1c27b0e4", "src": "social", "platform": "douyin", "lang": "zh-CN", "text": "新能源车续航实测，冬天打几折…", "author": { "uid_hash": "a19c04e7d2b3", "followers": null, "nickname": "车评老王", "uid": "108800000001", "sec_uid": "MS4wLjABAAAAexampleCreatorSecUid0000000000000001", "unique_id": null }, "metrics": { "likes": 120384, "comments": 8217, "shares": 5093, "saves": 14022 }, "extra": { "source_id": "7681000000000000001", "published_at": "2026-10-18T19:30:55+08:00", "video_dur_s": 47, "topic": "#新能源", "topics": [ "新能源" ], "content_type": "video", "cover_url": "https://p3-sign.douyinpic.com/tos-cn-i-0813/example~tplv-dy-resize-origshort-autoq-75:330.jpeg", "url": "https://www.douyin.com/video/7681000000000000001" }, "prov": { "hash": "0x527bcbac1d09e4f6", "ts": "2026-10-20T12:10:24+08:00", "source": "live" } } ], "cursor": 10, "has_more": true, "search_id": "20261020121024A1B2C3D4E5F60718293A", "prov": { "hash": "0x8f03b6d2e471ac95", "ts": "2026-10-20T12:10:24+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.000500", "balance_usd": "9.999500", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.douyin.search", "x-qovia-title-zh": "抖音综合搜索", "x-qovia-description-zh": "按关键词搜索视频和图文，返回统一作品记录（与作品详情同一 id）；翻页时带上一页的 cursor 和 search_id。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:douyin", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 500, "usd_per_call": "0.000500", "usd_per_1k": "0.5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.douyin.search/" } }, "/v1/raw/douyin/user_search": { "get": { "operationId": "raw_douyin_user_search", "summary": "Douyin user search", "description": "Keyword search for creators with nickname, sec_uid, followers, likes and verification, about 12 per page; pass the previous cursor and search_id to page.", "tags": [ "Douyin" ], "parameters": [ { "name": "keyword", "in": "query", "required": true, "description": "Search keyword", "x-qovia-description-zh": "搜索关键词", "schema": { "type": "string", "minLength": 1, "maxLength": 100, "examples": [ "汽车评测" ] }, "example": "汽车评测" }, { "name": "cursor", "in": "query", "required": false, "description": "The cursor from the previous page's response", "x-qovia-description-zh": "取上一页响应的 cursor", "schema": { "type": "integer", "minimum": 0, "maximum": 1000, "default": 0 } }, { "name": "search_id", "in": "query", "required": false, "description": "The search_id from the previous page's response; pass it when paging", "x-qovia-description-zh": "取上一页响应的 search_id；翻页时传入", "schema": { "type": "string", "pattern": "^[0-9A-Za-z]{10,64}$" } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "uid_hash": "a19c04e7d2b3", "nickname": "车评老王", "uid": "108800000001", "sec_uid": "MS4wLjABAAAAexampleCreatorSecUid0000000000000001", "unique_id": "chepinglaowang", "followers": 482100, "total_likes": 9820311, "verified": true, "verify_reason": "汽车自媒体", "signature": "十年汽车媒体人，只说真话。", "avatar_url": "https://p3-pc.douyinpic.com/aweme/100x100/aweme-avatar/example.jpeg", "url": "https://www.douyin.com/user/MS4wLjABAAAAexampleCreatorSecUid0000000000000001" } ], "cursor": 12, "has_more": true, "search_id": "20261020121209BF35533C2866EB71E5CE", "prov": { "hash": "0x6a1e9c03b5d7f284", "ts": "2026-10-20T12:12:09+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.000500", "balance_usd": "9.999500", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.douyin.user_search", "x-qovia-title-zh": "抖音用户搜索", "x-qovia-description-zh": "按关键词搜索创作者，返回昵称、sec_uid、粉丝、获赞和认证信息，每页约 12 个；翻页时带上一页的 cursor 和 search_id。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:douyin", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 500, "usd_per_call": "0.000500", "usd_per_1k": "0.5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.douyin.user_search/" } }, "/v1/raw/douyin/live_search": { "get": { "operationId": "raw_douyin_live_search", "summary": "Douyin live search", "description": "Keyword search for live rooms with title, current and total viewers, likes and host, about 15 per page.", "tags": [ "Douyin" ], "parameters": [ { "name": "keyword", "in": "query", "required": true, "description": "Search keyword", "x-qovia-description-zh": "搜索关键词", "schema": { "type": "string", "minLength": 1, "maxLength": 100, "examples": [ "汽车" ] }, "example": "汽车" }, { "name": "cursor", "in": "query", "required": false, "description": "The cursor from the previous page's response", "x-qovia-description-zh": "取上一页响应的 cursor", "schema": { "type": "integer", "minimum": 0, "maximum": 1000, "default": 0 } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "room_id": "7698502048890760000", "title": "新车到店，限时权益讲解", "is_live": true, "viewers": 295, "total_viewers": 30837, "likes": 106783, "started_at": "2026-10-20T06:00:02+08:00", "cover_url": "https://p3-webcast-sign.douyinpic.com/webcast-cover/example.image", "url": "https://live.douyin.com/151100000000", "author": { "uid_hash": "2be95d07c4a1", "nickname": "某汽车品牌官方", "uid": "2992200000000001", "sec_uid": "MS4wLjABAAAAexampleLiveHostSecUid000000000001", "followers": 329600, "verified": true, "verify_reason": "商家认证账号" } } ], "cursor": 15, "has_more": true, "prov": { "hash": "0x3c58e1f0a92b6d47", "ts": "2026-10-20T12:12:31+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.000500", "balance_usd": "9.999500", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.douyin.live_search", "x-qovia-title-zh": "抖音直播搜索", "x-qovia-description-zh": "按关键词搜索直播间：标题、在线人数、累计观看、点赞和主播信息，每页约 15 个。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:douyin", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 500, "usd_per_call": "0.000500", "usd_per_1k": "0.5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.douyin.live_search/" } }, "/v1/raw/douyin/goods_comments": { "get": { "operationId": "raw_douyin_goods_comments", "summary": "Douyin product reviews", "description": "Buyer reviews of a Douyin shop product with rating, text, SKU, tags and seller reply, 20 per page.", "tags": [ "Douyin" ], "parameters": [ { "name": "goods_id", "in": "query", "required": true, "description": "Douyin shop product ID (product_id)", "x-qovia-description-zh": "抖店商品 ID（product_id）", "schema": { "type": "string", "pattern": "^[1-9][0-9]{14,19}$", "examples": [ "3827812353530004447" ] }, "example": "3827812353530004447" }, { "name": "cursor", "in": "query", "required": false, "description": "Page number, from 0; the cursor from the previous page's response", "x-qovia-description-zh": "页码，从 0 开始；取上一页响应的 cursor", "schema": { "type": "integer", "minimum": 0, "maximum": 500, "default": 0 } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "cid": "2575695783160660259", "text": "质地很温和，宝宝用着没有不舒服", "rating": 5, "ratings": { "product": 5, "logistics": null, "shop": null }, "likes": 3, "created_at": "2026-10-20T09:08:16+08:00", "sku": "默认", "user_name": "西**r", "anonymous": false, "shop_reply": "感谢您的支持，期待再次光临！", "tags": [ "粉丝团" ], "keywords": [ "物美价廉" ] } ], "cursor": 1, "has_more": true, "total": 24, "prov": { "hash": "0x75b0d3e9a14c2f68", "ts": "2026-10-20T12:11:38+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.000500", "balance_usd": "9.999500", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.douyin.goods_comments", "x-qovia-title-zh": "抖音商品评价", "x-qovia-description-zh": "抖店商品的买家评价：评分、内容、SKU、标签和商家回复，每页 20 条。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:douyin", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 500, "usd_per_call": "0.000500", "usd_per_1k": "0.5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.douyin.goods_comments/" } }, "/v1/raw/douyin/creator_videos": { "get": { "operationId": "raw_douyin_creator_videos", "summary": "Douyin creator videos", "description": "Posts a creator published, pinned ones first and then newest first (or most popular first), about 20 a page, as the same records as video detail (same ids). Pass the previous page's cursor back to continue; stop when has_more is false. A creator without posts, or one that does not exist, answers empty and is not charged.", "tags": [ "Douyin" ], "parameters": [ { "name": "user_id", "in": "query", "required": true, "description": "The user's sec_uid (starts with MS4wLjABAAAA; Douyin rejects numeric uids)", "x-qovia-description-zh": "用户 sec_uid（MS4wLjABAAAA 开头；数字 uid 会被抖音拒绝）", "schema": { "type": "string", "pattern": "^MS4wLjABAAAA[0-9A-Za-z_-]{20,100}$", "examples": [ "MS4wLjABAAAAAKgMNYSx2pL3ARundki9oB8pmdvX9hVgujii5bnZUXs" ] }, "example": "MS4wLjABAAAAAKgMNYSx2pL3ARundki9oB8pmdvX9hVgujii5bnZUXs" }, { "name": "cursor", "in": "query", "required": false, "description": "The cursor from the previous page's response; 0 for the first page", "x-qovia-description-zh": "取上一页响应的 cursor；第一页为 0", "schema": { "type": "integer", "minimum": 0, "default": 0 } }, { "name": "sort", "in": "query", "required": false, "description": "Order: latest (the default) or popular", "x-qovia-description-zh": "排序：latest 最新（默认）、popular 最热门", "schema": { "type": "string", "enum": [ "latest", "popular" ], "default": "latest" } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "id": "soc_dou_e15ee224d064", "src": "social", "platform": "douyin", "lang": "zh-CN", "text": "小马长成了小马哥 静态体验奔腾小马五门版 曾经让鲍师傅爱不释手的奔腾小马，竟然推出了加长的五座版，不仅是尺寸的升级，更是把使用痛点进行了全面的消除，小马终于长成了小马哥。#奔腾小马…", "author": { "uid_hash": "d6f636c1d58b", "followers": null, "nickname": "爱车的BAO师傅", "uid": "108882376804", "sec_uid": "MS4wLjABAAAAAKgMNYSx2pL3ARundki9oB8pmdvX9hVgujii5bnZUXs", "unique_id": "dydyttmfh8s2" }, "metrics": { "likes": 10, "comments": 5, "shares": 6, "saves": 3 }, "extra": { "source_id": "7698963081988181257", "published_at": "2026-10-21T11:48:54+08:00", "video_dur_s": 425, "topic": "#奔腾小马", "topics": [ "奔腾小马", "奔腾小马五门版", "小马哥", "小车" ], "content_type": "video", "cover_url": "https://p3-sign.douyinpic.com/tos-cn-i-dy/da35ff97007541d0a3d61badb24d451f~tplv-dy-resize-walign-adapt-aq:540:q75.heic?lk3s=138a59ce&x-expires=1793804400&x-signature=4JgHOHab8Ibp8B24hkrPRKernM4%3D&from=327834062&s=PackSourceEnum_PUBLISH&se=false&sc=cover&biz_tag=aweme_video&l=20261021235008414FF27B970EAEBE0909", "url": "https://www.douyin.com/video/7698963081988181257" }, "prov": { "hash": "0x91eadd340b12fce9", "ts": "2026-10-21T23:50:08+08:00", "source": "live" } }, { "id": "soc_dou_5d11adb275ac", "src": "social", "platform": "douyin", "lang": "zh-CN", "text": "不要被外表欺骗这可是个狠角色 体验星钽5X 通常高颜值不意味着高性能，但星钽5X是个例外，特别是开上非铺装路面，这辆车才展现出它的真实实力。#北汽星钽5X #星钽5X #越野 #方…", "author": { "uid_hash": "d6f636c1d58b", "followers": null, "nickname": "爱车的BAO师傅", "uid": "108882376804", "sec_uid": "MS4wLjABAAAAAKgMNYSx2pL3ARundki9oB8pmdvX9hVgujii5bnZUXs", "unique_id": "dydyttmfh8s2" }, "metrics": { "likes": 13, "comments": 2, "shares": 0, "saves": 1 }, "extra": { "source_id": "7698752037126802723", "published_at": "2026-10-20T22:10:09+08:00", "video_dur_s": 678, "topic": "#北汽星钽5X", "topics": [ "北汽星钽5X", "星钽5X", "越野", "方盒子" ], "content_type": "video", "cover_url": "https://p3-sign.douyinpic.com/tos-cn-i-dy/5c2e9d385b1646f9b459007b94ad63d7~tplv-dy-resize-walign-adapt-aq:540:q75.heic?lk3s=138a59ce&x-expires=1793804400&x-signature=UZNm9x9JOTe1MNWDNA9zlRfW24M%3D&from=327834062&s=PackSourceEnum_PUBLISH&se=false&sc=cover&biz_tag=aweme_video&l=20261021235008414FF27B970EAEBE0909", "url": "https://www.douyin.com/video/7698752037126802723" }, "prov": { "hash": "0x755e43a674c7d2c1", "ts": "2026-10-21T23:50:08+08:00", "source": "live" } } ], "cursor": 1790514095000, "has_more": true, "prov": { "hash": "0xe81616f943e8d846", "ts": "2026-10-21T23:50:08+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.douyin.creator_videos", "x-qovia-title-zh": "抖音创作者作品列表", "x-qovia-description-zh": "一个创作者发布的作品，置顶作品在前，其余从新到旧（或按热门），每页约 20 条，记录与作品详情相同（同一 id）。 把上一页返回的 cursor 传回即可翻页，has_more 为 false 时停止。没有作品或用户不存在时返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:douyin", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.douyin.creator_videos/" } }, "/v1/raw/douyin/hot_search": { "get": { "operationId": "raw_douyin_hot_search", "summary": "Douyin hot search board", "description": "Douyin's hot search board: its pinned entry and about 50 ranked words, with rank, heat, views, related video count, label (new, hot, first, exclusive, challenge, debunk), time it entered and cover. The whole board in one answer, not paginated.", "tags": [ "Douyin" ], "parameters": [], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "rank": null, "word": "我们的长征路", "hot_value": null, "views": null, "video_count": null, "label": null, "pinned": true, "event_at": null, "cover_url": null, "sentence_id": "2706469", "url": "https://www.douyin.com/hot/2706469" }, { "rank": 1, "word": "国台办回应张凌赫赴台交流被拒", "hot_value": 11171737, "views": 61886247, "video_count": 5, "label": "hot", "pinned": false, "event_at": "2026-10-21T10:34:53+08:00", "cover_url": "https://p26-sign.douyinpic.com/tos-cn-p-0015/o0fBZ0GFLB3VsIYAe7PkACIBuvwggaKeAVEhuI~noop.jpeg?lk3s=bfd515bb&x-expires=1792616400&x-signature=%2FhMJAg9hJ%2BS4WvIxEcPl2HofYvg%3D&from=3218412987", "sentence_id": "2705737", "url": "https://www.douyin.com/hot/2705737" }, { "rank": 2, "word": "台风蔷琵正向我国方向靠近", "hot_value": 10909673, "views": 64390592, "video_count": 6, "label": "hot", "pinned": false, "event_at": "2026-10-21T14:36:53+08:00", "cover_url": "https://p9-sign.douyinpic.com/tos-cn-p-0015c000-ce/ok2EeyqMBX9bEwOAFFALxEIDYwKo2ggBpFfZLv~noop.jpeg?lk3s=bfd515bb&x-expires=1792616400&x-signature=7X4CIk7Y7m5fGAXSCkfsAl5XMRQ%3D&from=3218412987", "sentence_id": "2706231", "url": "https://www.douyin.com/hot/2706231" } ], "cursor": null, "has_more": false, "updated_at": "2026-10-21T23:47:40+08:00", "prov": { "hash": "0x27537f2e5ddc2017", "ts": "2026-10-21T23:51:06+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.douyin.hot_search", "x-qovia-title-zh": "抖音热榜", "x-qovia-description-zh": "抖音热榜（热点榜）：置顶词和约 50 个上榜词，含排名、热度值、浏览量、相关视频数、标签（新、热、首发、独家、挑战、辟谣）、上榜时间和封面。 一次返回整个榜单，不分页。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:douyin", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.douyin.hot_search/" } }, "/v1/raw/douyin/challenge_videos": { "get": { "operationId": "raw_douyin_challenge_videos", "summary": "Douyin hashtag videos", "description": "Posts under one hashtag, as the same records as video detail (same ids), about 10 a page; sort by relevance, most liked or latest. Pass the previous page's cursor back to continue; stop when has_more is false. A hashtag that does not exist answers 404 and one without posts answers empty, neither charged.", "tags": [ "Douyin" ], "parameters": [ { "name": "challenge_id", "in": "query", "required": true, "description": "Hashtag ID (the number in douyin.com/hashtag/)", "x-qovia-description-zh": "话题 ID（话题页链接 douyin.com/hashtag/ 里的数字）", "schema": { "type": "string", "pattern": "^[0-9]{6,20}$", "examples": [ "1600076256429059" ] }, "example": "1600076256429059" }, { "name": "cursor", "in": "query", "required": false, "description": "The cursor from the previous page's response; 0 for the first page", "x-qovia-description-zh": "取上一页响应的 cursor；第一页为 0", "schema": { "type": "integer", "minimum": 0, "maximum": 10000, "default": 0 } }, { "name": "sort", "in": "query", "required": false, "description": "Order: general (relevance, the default), most_liked or latest", "x-qovia-description-zh": "排序：general 综合（默认）、most_liked 最多点赞、latest 最新发布", "schema": { "type": "string", "enum": [ "general", "most_liked", "latest" ], "default": "general" } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "id": "soc_dou_812df8b3c827", "src": "social", "platform": "douyin", "lang": "zh-CN", "text": "最新！小鹏汽车官方回应苏州车祸事故… 小鹏汽车对此事件官方回应:对于该事故造成的人员及车辆损伤感到非常痛心。在后台接到碰撞告警后，小鹏汽车第一时间进行外呼并协调当地区域人员赶赴事故…", "author": { "uid_hash": "0dab4fe0480b", "followers": null, "nickname": "杭州日报", "uid": "1151906078000839", "sec_uid": "MS4wLjABAAAA9W4qYBkRHeKu4l-acUw0l8nmdHGbOO5FBsIDPDbg3cPFwo6u7NzDstlh9b6n3NrZ", "unique_id": "hangzhouribao" }, "metrics": { "likes": 1281304, "comments": 298837, "shares": 1765034, "saves": 74741 }, "extra": { "source_id": "7340931711024254248", "published_at": "2024-02-29T16:04:31+08:00", "video_dur_s": 16, "topic": "#江苏", "topics": [ "江苏", "新能源汽车" ], "content_type": "video", "cover_url": "https://p3-sign.douyinpic.com/tos-cn-i-0813c001/oMfBGH5wyIPsc6AAUcAA2bHfLAQx76fBGARHdE~tplv-dy-resize-walign-adapt-aq:360:q75.heic?lk3s=138a59ce&x-expires=1793804400&x-signature=80Nq1e9C6FtPwUKmCyLx8E1YGJY%3D&from=327834062&s=PackSourceEnum_CHALLENGE_AWEME&se=false&sc=cover&biz_tag=aweme_video&l=20261021235148CFA6034E28E05CB94920", "url": "https://www.douyin.com/video/7340931711024254248" }, "prov": { "hash": "0x88a74c6881d13ed6", "ts": "2026-10-21T23:51:50+08:00", "source": "live" } }, { "id": "soc_dou_f6deba33309f", "src": "social", "platform": "douyin", "lang": "zh-CN", "text": "历史性的时刻！宁德时代引爆能源革命，石油霸权真要熄火了？#科普#财经 #新能源汽车 ", "author": { "uid_hash": "13e5c0bd986d", "followers": null, "nickname": "直男财经", "uid": "2260189412334318", "sec_uid": "MS4wLjABAAAADUObyc_aoKXnXnV01JEcZMdvU0_ZFvFnVQAU-weztOgHubCQont1aDrDASxWu8B6", "unique_id": "zhinancaijing" }, "metrics": { "likes": 1153888, "comments": 43647, "shares": 40343, "saves": 10263 }, "extra": { "source_id": "6993383574028258574", "published_at": "2021-08-07T07:00:00+08:00", "video_dur_s": 278, "topic": "#科普", "topics": [ "科普", "财经", "新能源汽车" ], "content_type": "video", "cover_url": "https://p3-sign.douyinpic.com/tos-cn-p-0015/0d72e408b6954a7fbdddddea86b6c36b~tplv-dy-resize-walign-adapt-aq:360:q75.heic?lk3s=138a59ce&x-expires=1793804400&x-signature=MewF7Su3aMWTbVu7TKDdrrc8gao%3D&from=327834062&s=PackSourceEnum_CHALLENGE_AWEME&se=false&sc=cover&biz_tag=aweme_video&l=20261021235148CFA6034E28E05CB94920", "url": "https://www.douyin.com/video/6993383574028258574" }, "prov": { "hash": "0x6b1b575d8bb95ec9", "ts": "2026-10-21T23:51:50+08:00", "source": "live" } } ], "cursor": 10, "has_more": true, "prov": { "hash": "0x23d8f85b9c639bc2", "ts": "2026-10-21T23:51:50+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.douyin.challenge_videos", "x-qovia-title-zh": "抖音话题作品", "x-qovia-description-zh": "一个话题下的作品，记录与作品详情相同（同一 id），每页约 10 条；可按综合、最多点赞或最新发布排序。 把上一页返回的 cursor 传回即可翻页，has_more 为 false 时停止。话题不存在时返回 404，没有作品时返回空结果，均不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:douyin", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.douyin.challenge_videos/" } }, "/v1/raw/douyin/user_search_v2": { "get": { "operationId": "raw_douyin_user_search_v2", "summary": "Douyin user search V2", "description": "Keyword search for creators with nickname, sec_uid, followers, likes and verification, about 10 per page. To page, pass back both the previous page's cursor and search_id; stop when has_more is false. A single keyword often caps around 100 results (a depth limit). An empty result is not charged.", "tags": [ "Douyin" ], "parameters": [ { "name": "keyword", "in": "query", "required": true, "description": "Search keyword", "x-qovia-description-zh": "搜索关键词", "schema": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "\\S", "examples": [ "美食" ] }, "example": "美食" }, { "name": "cursor", "in": "query", "required": false, "description": "The cursor from the previous page's response; 0 for the first page", "x-qovia-description-zh": "取上一页响应的 cursor；第一页为 0", "schema": { "type": "integer", "minimum": 0, "maximum": 1000, "default": 0 } }, { "name": "search_id", "in": "query", "required": false, "description": "The search_id from the previous page's response; pass it with cursor when paging", "x-qovia-description-zh": "取上一页响应的 search_id；翻页时与 cursor 一起传", "schema": { "type": "string", "pattern": "^[0-9A-Za-z]{10,64}$" } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "uid_hash": "5c2e91a07b3d", "nickname": "美食侦探888", "uid": "2290120000000001", "sec_uid": "MS4wLjABAAAA_OsYGGnNOzZ3rgeVNF3o-b-cL9NwCJr7tfNiUAKHgMKRu5a9a8kYrEy9o_sdfIOs", "unique_id": "meishizhentan888", "followers": 1204000, "total_likes": 15830200, "verified": false, "verify_reason": null, "signature": "每天一家宝藏小店", "avatar_url": "https://p3-pc.douyinpic.com/aweme/1080x1080/aweme-avatar/example.jpeg", "url": "https://www.douyin.com/user/MS4wLjABAAAA_OsYGGnNOzZ3rgeVNF3o-b-cL9NwCJr7tfNiUAKHgMKRu5a9a8kYrEy9o_sdfIOs" } ], "cursor": 10, "has_more": true, "search_id": "2026103017575449B6CC5EEFB17408CAE0", "prov": { "hash": "0x6a1e9c03b5d7f284", "ts": "2026-10-30T17:58:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.012000", "balance_usd": "9.988000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.douyin.user_search_v2", "x-qovia-title-zh": "抖音用户搜索 V2", "x-qovia-description-zh": "按关键词搜索创作者，返回昵称、sec_uid、粉丝、获赞和认证信息，每页约 10 个。翻页时请同时传回上一页返回的 cursor 和 search_id，has_more 为 false 时停止；同一关键词通常最多翻到约 100 个结果（深度上限）。 没有结果时返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:douyin", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 12000, "usd_per_call": "0.012000", "usd_per_1k": "12" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.douyin.user_search_v2/" } }, "/v1/raw/douyin/video_v2": { "get": { "operationId": "raw_douyin_video_v2", "summary": "Douyin post detail V2", "description": "One Douyin post, a video or an image post (图文, aweme_type 68), returned as Douyin's own JSON (aweme_detail): the caption desc, author, statistics, music; videos carry a video object, image posts the full images list (every image with its url_list). item_id takes a post ID or a link: douyin.com/video/, douyin.com/note/ (query parameters are fine), iesdouyin.com/share/(video|note|slides)/, a v.douyin.com short link, or a whole pasted share text that contains such a link. A post that does not exist answers 404 and is not charged.", "tags": [ "Douyin" ], "parameters": [ { "name": "item_id", "in": "query", "required": true, "description": "Post ID, or a post link / pasted share text (douyin.com/video/, douyin.com/note/ or a v.douyin.com short link)", "x-qovia-description-zh": "作品 ID 或作品链接/分享文案（douyin.com/video/、douyin.com/note/、v.douyin.com 短链接均可）", "schema": { "type": "string", "minLength": 1, "maxLength": 2000, "examples": [ "7705744790155735545" ] }, "example": "7705744790155735545" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "aweme_id": "7705744790155735545", "aweme_type": 68, "desc": "给集大学弟整理的一份好吃的清单🧾", "create_time": 1794133519, "author": { "nickname": "胖兔吃不胖", "uid": "7697521569191347237", "sec_uid": "MS4wLjABAAAAl4zCZaJnmb64U38lhJvdwsECMnPQErMR5kknYkOGVN5A1f7ie-r2eTN88M6NFWrW", "unique_id": "54676984446" }, "statistics": { "digg_count": 545, "comment_count": 90, "share_count": 591, "collect_count": 397 }, "images": [ { "url_list": [ "https://p26-sign.douyinpic.com/tos-cn-i-wftb4kr1i9/example-1~tplv-wftb4kr1i9-origin.image" ], "width": 1440, "height": 3130 }, { "url_list": [ "https://p3-sign.douyinpic.com/tos-cn-i-wftb4kr1i9/example-2~tplv-wftb4kr1i9-origin.image" ], "width": 1440, "height": 3130 } ], "share_url": "https://www.iesdouyin.com/share/note/7705744790155735545/" }, "meta": { "billed": true, "charged_usd": "0.001200", "balance_usd": "9.998800", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.douyin.video_v2", "x-qovia-title-zh": "抖音作品详情 V2", "x-qovia-description-zh": "单个抖音作品（视频或图文），原样返回抖音自己的 JSON（aweme_detail）：文案 desc、作者、点赞/评论/分享/收藏等统计、 音乐；视频带 video 字段，图文（aweme_type 68）带完整的 images 列表（每张图都有 url_list）。 item_id 可填作品 ID，或作品链接：douyin.com/video/、douyin.com/note/（可带查询参数）、 iesdouyin.com/share/(video|note|slides)/、v.douyin.com 短链接，也可以直接粘贴整段分享文案（含上述链接）。 作品不存在时返回 404，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:douyin", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1200, "usd_per_call": "0.001200", "usd_per_1k": "1.2" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.douyin.video_v2/" } }, "/v1/raw/douyin/goods_comments_v2": { "get": { "operationId": "raw_douyin_goods_comments_v2", "summary": "Douyin product reviews V2", "description": "Buyer reviews of a Douyin e-commerce product, returned as Douyin answers in JSON: the Comments list (20 per page, each with text and time, ratings, SKU, likes, shop reply, the buyer's nickname and avatar, photos), plus the review total Count and HasMore. goods_id is the Douyin e-commerce product ID; page starts at 1; stop paging when HasMore is false. It usually answers in about 3 seconds. Only an answer with data is charged; a product without reviews, or an error, is not.", "tags": [ "Douyin" ], "parameters": [ { "name": "goods_id", "in": "query", "required": true, "description": "Douyin e-commerce product ID", "x-qovia-description-zh": "抖音电商商品 ID", "schema": { "type": "string", "pattern": "^[1-9][0-9]{14,19}$", "examples": [ "3633772266610903778" ] }, "example": "3633772266610903778" }, { "name": "page", "in": "query", "required": false, "description": "Page number, from 1; stop when HasMore is false", "x-qovia-description-zh": "页码，从 1 开始；HasMore 为 false 时停止", "schema": { "type": "integer", "minimum": 1, "maximum": 500, "default": 1 } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "Comments": [ { "AppId": 1128, "AppealStatus": 0, "BrowseCount": 0, "CanAppend": true, "CommentTime": "2026-10-31 11:36:10", "CommentType": 0, "Content": "不好用，颜色显黑", "Id": 154058806702227746, "IsAbnormalOrder": 0, "IsAnonymous": false, "KolId": 17621898709, "Liked": false, "Likes": 0, "Order": "{\"shop_name\":\"喵妮美妆严选\",\"create_time\":1792757925,\"combo_num\":1,\"combo_id\":1774302852896819,\"combo_amount\":2990,\"pay_type\":1}", "OrderSnapshot": { "author_id": 17621898709, "order_create_time": 1792757925, "order_item_num": 1, "order_item_origin_amount": 2990, "order_sku_id": 1774302852896819, "order_sku_name": "色号", "order_sku_price": 2990, "pay_type": 1, "product_image": "https://p9-aio.ecombdimg.com/obj/ecom-shop-material/png_m_64c4308812882e5da75c2f9146d31af2_sx_192360_www800-800", "product_name": "【品牌正品】米之莲奢感不沾杯口红哑光雾面持妆显白不易掉色提升气色学生", "shop_id": 113503652, "shop_name": "喵妮美妆严选", "shop_order_id": 6918846676153872017 }, "OrigContent": "", "ParentId": 0, "Product": "{\"name\":\"米之莲奢感不沾杯口红哑光雾面持妆显白不易掉色提升气色学生\",\"pay_type\":1,\"img\":\"https://p3-ecom-commentpic-sign.byteimg.com/ecom-shop-material/png_m_64c4308812882e5da75c2f9146d31af2…", "ProductChannelId": "3705963630465538", "ProductChannelType": "4", "ProductId": 3633772266610903778, "Rank": 1, "RankLogistic": 0, "RankProduct": 1, "RankShop": 0, "Recommend": false, "ShopId": 113503652, "ShopReply": "", "ShowTags": [ { "tag_content": "", "tag_extra": {}, "tag_icon": { "height": 18, "id": 0, "thumbnail": "", "uri": "tos-cn-i-fceoirpogb/comment_level/lv1.png", "url": "http://p3-ecom-commentpic.byteimg.com/tos-cn-i-fceoirpogb/comment_level/lv1.png~tplv-fceoirpogb-image.image", "width": 35 }, "tag_title": "", "tag_type": 2 } ], "Sku": "01#肉桂奶茶", "SourceFrom": 0, "Status": 0, "StoreId": 0, "UserAvatar": "https://p9-product-comment-sign.byteimg.com/aweme-avatar/tos-cn-i-0813c001_oUAEBAuFQWAUmLAAI7NMEzeeHsOActUWxBe8E5~tplv-8y5sebgt5i-re_cp:100:100:q100.jpeg?lk3s=e…", "UserName": "家**2", "UserType": 12 } ], "Count": 2114, "HasMore": true }, "meta": { "billed": true, "charged_usd": "0.016910", "balance_usd": "9.983090", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.douyin.goods_comments_v2", "x-qovia-title-zh": "抖音商品评价 V2", "x-qovia-description-zh": "抖音电商商品的买家评价（按抖音的原样 JSON 返回）：Comments 列表（每页 20 条，含评价内容和时间、评分、SKU、点赞数、商家回复、买家昵称和头像、晒图），以及评价总数 Count 和是否还有下一页 HasMore。 goods_id 填抖音电商的商品 ID，page 从 1 开始，HasMore 为 false 时停止翻页。一般 3 秒左右返回。 只对有数据的结果计费，没有评价或出错都不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:douyin", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 16910, "usd_per_call": "0.016910", "usd_per_1k": "16.91" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.douyin.goods_comments_v2/" } }, "/v1/raw/douyin/goods_search": { "get": { "operationId": "raw_douyin_goods_search", "summary": "Douyin product search", "description": "Keyword search of Douyin shop products, returned as Douyin answers in JSON: the promotions list (product ID, promotion ID, title, main picture, detail link, categories), summary_promotions with the product cards (monthly sales, good-review ratio, price, commission, shop name and score, tags), plus total, has_more and the search_id inside extra. page starts at 1 with about 30 per page; to turn the page pass the search_id from the previous page's extra back as search_id, and stop when has_more is false. Responses usually take about 4 seconds. Only an answer with data is charged; no match or an error is not.", "tags": [ "Douyin" ], "parameters": [ { "name": "keyword", "in": "query", "required": true, "description": "Search keyword", "x-qovia-description-zh": "搜索关键词", "schema": { "type": "string", "minLength": 1, "maxLength": 100, "examples": [ "口红" ] }, "example": "口红" }, { "name": "page", "in": "query", "required": false, "description": "Page number, from 1; stop when has_more is false", "x-qovia-description-zh": "页码，从 1 开始；has_more 为 false 时停止", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1 } }, { "name": "search_id", "in": "query", "required": false, "description": "Paging: the extra.search_id returned by the previous page, passed back unchanged; omit it for the first page", "x-qovia-description-zh": "翻页用：上一页返回 extra.search_id，原样传回；第一页不传", "schema": { "type": "string", "minLength": 1, "maxLength": 512, "pattern": "^[0-9A-Za-z_-]+$" } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "promotions": [ { "product_id": "3633772266610903778", "promotion_id": "3641755479459406882", "base_info": { "title": "【品牌正品】米之莲奢感不沾杯口红哑光雾面持妆显白不易掉色提升气色学生", "price": null, "main_img": { "uri": "ecom-shop-material/png_m_64c4308812882e5da75c2f9146d31af2_sx_192360_www800-800", "url_list": [ "https://p3-aio.ecombdimg.com/obj/ecom-shop-material/png_m_64c4308812882e5da75c2f9146d31af2_sx_192360_www800-800" ] }, "detail_url": "https://haohuo.jinritemai.com/ecommerce/trade/detail/index.html?id=3633772266610903778&origin_type=2631", "category": { "first_category": { "category_id": 1000002395, "category_name": "彩妆香水" }, "second_category": { "category_id": 1000002412, "category_name": "唇部彩妆" }, "third_category": { "category_id": 1000002526, "category_name": "有色唇膏/口红" }, "fourth_category": { "category_id": 0, "category_name": "" }, "leaf_layer": 3 } } } ], "has_more": true, "total": 500, "extra": { "channel_id": "200", "recall_type": "Search", "search_id": "9693f4b04995e774b8d36aca1ae771d3..." }, "summary_promotions": [ { "product_id": "3633772266610903778", "promotion_id": "3641755479459406882", "base_model": { "product_info": { "name": "【品牌正品】米之莲奢感不沾杯口红哑光雾面持妆显白不易掉色提升气色学生", "detail_url": "https://haohuo.jinritemai.com/ecommerce/trade/detail/index.html?id=3633772266610903778&origin_type=2631", "month_sale": { "origin": 1669 }, "good_ratio": { "origin": 94.79961832061069, "integer": "94", "decimal": "8", "suffix": "%" } }, "marketing_info": { "price_desc": { "price": { "origin": 2990, "integer": "29", "decimal": "9", "suffix": "" }, "price_text": "到手价" } }, "shop_info": { "shop_id": 113503652, "shop_name": "喵妮美妆严选" } } } ] }, "meta": { "billed": true, "charged_usd": "0.025360", "balance_usd": "9.974640", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.douyin.goods_search", "x-qovia-title-zh": "抖音商品搜索", "x-qovia-description-zh": "按关键词搜索抖音电商的商品（按抖音的原样 JSON 返回）：promotions 商品列表（商品 ID、推广 ID、标题、主图、详情链接、类目），summary_promotions 商品详情卡片（月销量、好评率、到手价、佣金、店铺名称和评分、标签），以及 total 总数、has_more 是否还有下一页和 extra 里的 search_id。page 从 1 开始，每页约 30 条；翻页时把上一页 extra 里的 search_id 作为 search_id 传回，has_more 为 false 时停止。一般 4 秒左右返回。只对有数据的结果计费，没有搜到商品或出错都不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:douyin", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 25360, "usd_per_call": "0.025360", "usd_per_1k": "25.36" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.douyin.goods_search/" } }, "/v1/raw/kuaishou/video": { "get": { "operationId": "raw_kuaishou_video", "summary": "Kuaishou video detail", "description": "One Kuaishou post: caption, author (numeric uid, eid and Kuaishou ID), play / like / comment / share / save counts, hashtags, publish time (Beijing time), duration, cover and link. Pass the post's eid (the part of its link, such as 3xry7mhn2ywjyqg); the numeric photo_id is not accepted. A post that does not exist or was deleted answers 404 and is not charged.", "tags": [ "Kuaishou" ], "parameters": [ { "name": "video_id", "in": "query", "required": true, "description": "The post's eid (from www.kuaishou.com/short-video/; a post record's extra.eid)", "x-qovia-description-zh": "作品 eid（作品链接 www.kuaishou.com/short-video/ 里的部分，也是作品记录的 extra.eid）", "schema": { "type": "string", "pattern": "^3x[0-9a-z]{10,20}$", "examples": [ "3xry7mhn2ywjyqg" ] }, "example": "3xry7mhn2ywjyqg" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "id": "soc_kua_892e0d923045", "src": "social", "platform": "kuaishou", "lang": "zh-CN", "text": "绝 望 鸭 脖", "author": { "uid_hash": "ec1f004e8813", "followers": null, "nickname": "权少爱吃小汉堡🍔", "uid": "228905802", "eid": "3xz63mn6fngqtiq", "unique_id": "quanshaogmod" }, "metrics": { "likes": 536223, "comments": 33273, "shares": 203274, "saves": 141600, "plays": 9258156 }, "extra": { "source_id": "5220235068916084263", "eid": "3xry7mhn2ywjyqg", "published_at": "2024-12-13T17:17:22+08:00", "video_dur_s": 23, "topic": null, "topics": [], "content_type": "video", "cover_url": "https://ws2.a.kwimgs.com/upic/2024/12/13/17/BMjAyNDEyMTMxNzE2NDFfMjI4OTA1ODAyXzE1MTA0ODI0NzI0N18yXzM=_hd_Be0f7de6d81e02b08996d9b43b1a8bb62.kvif?tag=1-1792597682-sp-0-knz0inf6a6-d3a11a040b0c8138&type=hot&clientCacheKey=3xry7mhn2ywjyqg_hd.kvif&di=4c9d6c8d&bp=10321", "ip_location": null, "url": "https://www.kuaishou.com/short-video/3xry7mhn2ywjyqg" }, "prov": { "hash": "0xae1f5e598aff2701", "ts": "2026-10-21T23:50:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.kuaishou.video", "x-qovia-title-zh": "快手作品详情", "x-qovia-description-zh": "单个快手作品：文案、作者（数字 uid、eid、快手号）、播放/点赞/评论/分享/收藏数、话题、发布时间（北京时间）、时长、封面和链接。 传作品 eid（作品链接里的那段，如 3xry7mhn2ywjyqg），不支持数字 photo_id。作品不存在或已删除时返回 404，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:kuaishou", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.kuaishou.video/" } }, "/v1/raw/kuaishou/comments": { "get": { "operationId": "raw_kuaishou_comments", "summary": "Kuaishou video comments", "description": "First-level comments of a post, cursor-paginated (about 30 on the first page, then about 20): text, likes, reply count, IP location, time (Beijing time), whether it is a hot comment, whether the creator liked it, comment images and the commenter. Pass the previous page's cursor back to continue; stop when has_more is false. Replies come from raw.kuaishou.comment_replies. A post without comments, or one that does not exist, answers empty and is not charged.", "tags": [ "Kuaishou" ], "parameters": [ { "name": "video_id", "in": "query", "required": true, "description": "The post's eid (a post record's extra.eid)", "x-qovia-description-zh": "作品 eid（作品记录的 extra.eid）", "schema": { "type": "string", "pattern": "^3x[0-9a-z]{10,20}$", "examples": [ "3xry7mhn2ywjyqg" ] }, "example": "3xry7mhn2ywjyqg" }, { "name": "cursor", "in": "query", "required": false, "description": "The cursor from the previous page's response; leave out for the first page", "x-qovia-description-zh": "取上一页响应的 cursor；第一页不传", "schema": { "type": "string", "pattern": "^[A-Za-z0-9#_=+/.:-]{1,300}$" } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "cid": "930503828225", "text": "知道为什么他在中间吗？", "likes": 8029, "ip_location": "浙江", "reply_count": 315, "created_at": "2024-12-13T19:44:09+08:00", "is_hot": true, "liked_by_author": false, "images": [ "https://p23-plat.wsukwai.com/kimg/EL7M1y8qHQoFaW1hZ2USB2NvbW1lbnQaCzh5TnNfelRPVUFz.heif" ], "author": { "uid_hash": "7f5649c75ecd", "nickname": "绝***丑", "uid": "1000000001", "eid": null, "unique_id": null } }, { "cid": "1182321872417", "text": "你终于来了", "likes": 73, "ip_location": "新疆", "reply_count": 30, "created_at": "2026-10-02T22:56:30+08:00", "is_hot": true, "liked_by_author": false, "images": [ "https://p23-plat.wsukwai.com/kimg/EL7M1y8qIQoFaW1hZ2USB2NvbW1lbnQaD3pFekRqNUl4TElVLmpwZw.heif" ], "author": { "uid_hash": "cf94093b6381", "nickname": "l***k", "uid": "1000000002", "eid": null, "unique_id": null } } ], "cursor": "V2#afffa92b-e09a-4398-b60e-728051c274a4#dph#30#1074226454740_30", "has_more": true, "total": 33273, "prov": { "hash": "0xbd89c98343292ae8", "ts": "2026-10-21T23:50:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.kuaishou.comments", "x-qovia-title-zh": "快手作品评论", "x-qovia-description-zh": "作品的一级评论，按游标翻页（首页约 30 条，之后约 20 条）：评论内容、点赞数、回复数、IP 属地、时间（北京时间）、是否热评、作者是否赞过、评论图片和评论者。 把上一页返回的 cursor 传回即可翻页，has_more 为 false 时停止。回复用 raw.kuaishou.comment_replies 获取。没有评论或作品不存在时返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:kuaishou", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.kuaishou.comments/" } }, "/v1/raw/kuaishou/comment_replies": { "get": { "operationId": "raw_kuaishou_comment_replies", "summary": "Kuaishou comment replies", "description": "Replies under one first-level comment, cursor-paginated, about 12 a page: text, likes, IP location, time (Beijing time), the user replied to, and the replier. Pass the previous page's cursor back to continue; stop when has_more is false. Kuaishou reports no reply total. A comment without replies answers empty and is not charged.", "tags": [ "Kuaishou" ], "parameters": [ { "name": "video_id", "in": "query", "required": true, "description": "The post's eid (a post record's extra.eid)", "x-qovia-description-zh": "作品 eid（作品记录的 extra.eid）", "schema": { "type": "string", "pattern": "^3x[0-9a-z]{10,20}$", "examples": [ "3xry7mhn2ywjyqg" ] }, "example": "3xry7mhn2ywjyqg" }, { "name": "comment_id", "in": "query", "required": true, "description": "The first-level comment's cid (from the video comments endpoint)", "x-qovia-description-zh": "一级评论的 cid（来自作品评论接口）", "schema": { "type": "string", "pattern": "^[0-9]{6,20}$", "examples": [ "930503828225" ] }, "example": "930503828225" }, { "name": "cursor", "in": "query", "required": false, "description": "The cursor from the previous page's response; leave out for the first page", "x-qovia-description-zh": "取上一页响应的 cursor；第一页不传", "schema": { "type": "string", "pattern": "^[A-Za-z0-9#_=+/.:-]{1,300}$" } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "cid": "930503985009", "text": "对了，还有一个", "likes": 5487, "ip_location": "浙江", "reply_count": null, "created_at": "2024-12-13T19:44:25+08:00", "is_hot": false, "liked_by_author": false, "images": [ "https://p23-plat.wsukwai.com/kimg/EL7M1y8qHQoFaW1hZ2USB2NvbW1lbnQaC3dPR3FMdEJBTksw.heif" ], "author": { "uid_hash": "7f5649c75ecd", "nickname": "绝***丑", "uid": "1000000001", "eid": null, "unique_id": null }, "parent_cid": "930503828225", "reply_to": { "uid_hash": "7f5649c75ecd", "nickname": "绝***丑", "uid": "1000000001" } }, { "cid": "930704238063", "text": "[柴犬]", "likes": 0, "ip_location": "四川", "reply_count": null, "created_at": "2024-12-14T08:32:21+08:00", "is_hot": false, "liked_by_author": false, "images": [], "author": { "uid_hash": "eef9d45fc700", "nickname": "用***机", "uid": "1000000003", "eid": null, "unique_id": null }, "parent_cid": "930503828225", "reply_to": { "uid_hash": "b29983256aaa", "nickname": "H***9", "uid": "1000000004" } } ], "cursor": "930909643517", "has_more": true, "total": null, "prov": { "hash": "0x1ed3ead45b4c1395", "ts": "2026-10-21T23:50:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.kuaishou.comment_replies", "x-qovia-title-zh": "快手评论回复", "x-qovia-description-zh": "某条一级评论下的回复（楼中楼），按游标翻页，每页约 12 条：回复内容、点赞数、IP 属地、时间（北京时间）、被回复的用户和回复者。 把上一页返回的 cursor 传回即可翻页，has_more 为 false 时停止。快手不提供回复总数。没有回复时返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:kuaishou", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.kuaishou.comment_replies/" } }, "/v1/raw/kuaishou/creator_hot_videos": { "get": { "operationId": "raw_kuaishou_creator_hot_videos", "summary": "Kuaishou creator hot videos", "description": "A creator's hot posts, most liked first, 20 a page, as the same records as video detail (same ids). Pass the numeric uid (the author.uid of a post or comment record). Pass the previous page's cursor back to continue; stop when has_more is false. A creator without posts, or a user that does not exist, answers empty and is not charged.", "tags": [ "Kuaishou" ], "parameters": [ { "name": "uid", "in": "query", "required": true, "description": "The user's numeric uid (the author.uid of a post or comment record), not the eid", "x-qovia-description-zh": "用户数字 uid（作品或评论记录的 author.uid），不是 eid", "schema": { "type": "string", "pattern": "^[0-9]{1,20}$", "examples": [ "228905802" ] }, "example": "228905802" }, { "name": "cursor", "in": "query", "required": false, "description": "The cursor from the previous page's response; leave out for the first page", "x-qovia-description-zh": "取上一页响应的 cursor；第一页不传", "schema": { "type": "string", "pattern": "^[A-Za-z0-9#_=+/.:-]{1,300}$" } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "id": "soc_kua_892e0d923045", "src": "social", "platform": "kuaishou", "lang": "zh-CN", "text": "绝 望 鸭 脖", "author": { "uid_hash": "ec1f004e8813", "followers": null, "nickname": "权少爱吃小汉堡🍔", "uid": "228905802", "eid": "3xz63mn6fngqtiq", "unique_id": "quanshaogmod" }, "metrics": { "likes": 536223, "comments": 33273, "shares": 203274, "saves": 141600, "plays": 9258156 }, "extra": { "source_id": "5220235068916084263", "eid": "3xry7mhn2ywjyqg", "published_at": "2024-12-13T17:17:22+08:00", "video_dur_s": 23, "topic": null, "topics": [], "content_type": "video", "cover_url": "https://tx2.a.yximgs.com/upic/2024/12/13/17/BMjAyNDEyMTMxNzE2NDFfMjI4OTA1ODAyXzE1MTA0ODI0NzI0N18yXzM=_480p_B4efb6ba5cc46a45b5c0a0aaa01501c37.kvif?tag=1-1792597593-p-0-5967be10b83044ab-3d4b358efb604372&type=hot&clientCacheKey=3xry7mhn2ywjyqg_480p.kvif&di=71f51c4b&bp=10001", "ip_location": "辽宁", "url": "https://www.kuaishou.com/short-video/3xry7mhn2ywjyqg" }, "prov": { "hash": "0x5a084be3780470c7", "ts": "2026-10-21T23:50:00+08:00", "source": "live" } }, { "id": "soc_kua_1a62daa69faa", "src": "social", "platform": "kuaishou", "lang": "zh-CN", "text": "跳 舞 鸭 脖 2 #gmod #老鼠舞", "author": { "uid_hash": "ec1f004e8813", "followers": null, "nickname": "权少爱吃小汉堡🍔", "uid": "228905802", "eid": "3xz63mn6fngqtiq", "unique_id": "quanshaogmod" }, "metrics": { "likes": 402005, "comments": 21750, "shares": 94677, "saves": 115752, "plays": 7817114 }, "extra": { "source_id": "5206442799671854712", "eid": "3xj2cyw5d3sd68y", "published_at": "2025-02-06T17:21:20+08:00", "video_dur_s": 16, "topic": "#gmod", "topics": [ "gmod", "老鼠舞" ], "content_type": "video", "cover_url": "https://tx2.a.yximgs.com/upic/2025/02/06/17/BMjAyNTAyMDYxNzIwNTlfMjI4OTA1ODAyXzE1NjE0MzA1Mzg0MV8yXzM=_480p_Bb51a689a854580934fcbf3a41070de92.kvif?tag=1-1792597593-p-0-5967be10b83044ab-3d4b358efb604372&type=hot&clientCacheKey=3xj2cyw5d3sd68y_480p.kvif&di=71f51c4b&bp=10001", "ip_location": "辽宁", "url": "https://www.kuaishou.com/short-video/3xj2cyw5d3sd68y" }, "prov": { "hash": "0x4696d7b36a56eff5", "ts": "2026-10-21T23:50:00+08:00", "source": "live" } } ], "cursor": "20", "has_more": true, "prov": { "hash": "0x2fb7e994bc49c079", "ts": "2026-10-21T23:50:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.kuaishou.creator_hot_videos", "x-qovia-title-zh": "快手创作者热门作品", "x-qovia-description-zh": "一个创作者的热门作品，按点赞从高到低，每页 20 条，记录与作品详情相同（同一 id）。传数字 uid（作品或评论记录的 author.uid）。 把上一页返回的 cursor 传回即可翻页，has_more 为 false 时停止。没有作品或用户不存在时返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:kuaishou", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.kuaishou.creator_hot_videos/" } }, "/v1/raw/kuaishou/hot_board": { "get": { "operationId": "raw_kuaishou_hot_board", "summary": "Kuaishou hot board", "description": "Kuaishou's hot board (the main board) as it stands, about 50 words: rank, word, heat value, views, the board's tag (such as 霸榜中 \"holding the top\" or 18:20登顶 \"reached #1 at 18:20\") and a search link; pinned words come first (pinned true, no rank). One whole board per call, no paging, no params. An empty board answers empty and is not charged.", "tags": [ "Kuaishou" ], "parameters": [], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "rank": 5, "keyword": "钟意长生拥抱", "hot_value": 11672034, "views": 12229119, "label": "1.7万点赞", "pinned": false, "word_id": "6394393", "url": "https://www.kuaishou.com/search/video?searchKey=%E9%92%9F%E6%84%8F%E9%95%BF%E7%94%9F%E6%8B%A5%E6%8A%B1" }, { "rank": 6, "keyword": "AG年总止步突围赛", "hot_value": 11461345, "views": 12162235, "label": "1.3万点赞", "pinned": false, "word_id": "6394299", "url": "https://www.kuaishou.com/search/video?searchKey=AG%E5%B9%B4%E6%80%BB%E6%AD%A2%E6%AD%A5%E7%AA%81%E5%9B%B4%E8%B5%9B" } ], "prov": { "hash": "0xce3b4c4dd72abfec", "ts": "2026-10-21T23:50:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.kuaishou.hot_board", "x-qovia-title-zh": "快手热榜", "x-qovia-description-zh": "快手热榜（主榜）当前的整张榜单，约 50 个热词：排名、热词、热度值、浏览量、榜单标签（如“霸榜中”“18:20登顶”）和搜索链接；置顶词排在最前（pinned 为 true，没有排名）。 每次返回整张榜单，不分页，无需参数。榜单为空时返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:kuaishou", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.kuaishou.hot_board/" } }, "/v1/raw/kuaishou/video_v2": { "get": { "operationId": "raw_kuaishou_video_v2", "summary": "Kuaishou video detail V2", "description": "One Kuaishou post by its numeric photo_id: caption, author, play / like / comment counts, publish time, duration, cover and link. Responses are slow (up to about 90 seconds). A post that does not exist or was deleted answers 404 and is not charged.", "tags": [ "Kuaishou" ], "parameters": [ { "name": "photo_id", "in": "query", "required": true, "description": "The post's numeric photo_id", "x-qovia-description-zh": "作品的数字 photo_id", "schema": { "type": "string", "pattern": "^[0-9]{6,25}$", "examples": [ "5220235068916084263" ] }, "example": "5220235068916084263" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "photo_id": "5220235068916084263", "caption": "示例作品文案", "user_id": "228905802", "nickname": "示例作者", "play_count": 9258156, "like_count": 536223, "comment_count": 33273, "duration_ms": 23000, "timestamp": 1734081442000, "cover_url": "https://example.com/cover.jpg", "url": "https://www.kuaishou.com/short-video/3xry7mhn2ywjyqg" }, "meta": { "billed": true, "charged_usd": "0.000500", "balance_usd": "9.999500", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.kuaishou.video_v2", "x-qovia-title-zh": "快手作品详情 V2", "x-qovia-description-zh": "用数字 photo_id 查询单个快手作品：文案、作者、播放/点赞/评论数、发布时间、时长、封面和链接。 响应较慢（最长约 90 秒）。作品不存在或已删除时返回 404，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:kuaishou", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 500, "usd_per_call": "0.000500", "usd_per_1k": "0.5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.kuaishou.video_v2/" } }, "/v1/raw/kuaishou/comments_v2": { "get": { "operationId": "raw_kuaishou_comments_v2", "summary": "Kuaishou video comments V2", "description": "First-level comments of a post, cursor-paginated, newest first (desc, the default) or oldest first (asc); count is the page size. Pass the previous page's cursor back as pcursor to continue; stop when has_more is false. Replies come from raw.kuaishou.comment_replies_v2. Responses are slow (up to about 90 seconds). A post without comments answers empty and one that does not exist answers 404; neither is charged.", "tags": [ "Kuaishou" ], "parameters": [ { "name": "photo_id", "in": "query", "required": true, "description": "The post's numeric photo_id", "x-qovia-description-zh": "作品的数字 photo_id", "schema": { "type": "string", "pattern": "^[0-9]{6,25}$", "examples": [ "5220235068916084263" ] }, "example": "5220235068916084263" }, { "name": "pcursor", "in": "query", "required": false, "description": "Page cursor; empty for the first page, then the previous page's cursor", "x-qovia-description-zh": "翻页游标；首页留空，之后传上一页返回的 cursor", "schema": { "type": "string", "maxLength": 200, "default": "" } }, { "name": "count", "in": "query", "required": false, "description": "Comments per page", "x-qovia-description-zh": "每页条数", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 } }, { "name": "order", "in": "query", "required": false, "description": "Order: desc is newest first, asc is oldest first", "x-qovia-description-zh": "排序：desc 最新在前，asc 最早在前", "schema": { "type": "string", "enum": [ "desc", "asc" ], "default": "desc" } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "comment_id": "20123456789", "content": "示例评论", "user_id": "228905802", "nickname": "示例用户", "like_count": 12, "reply_count": 3, "timestamp": 1734081442000 } ], "cursor": "1734081442000", "has_more": true }, "meta": { "billed": true, "charged_usd": "0.000500", "balance_usd": "9.999500", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.kuaishou.comments_v2", "x-qovia-title-zh": "快手作品评论 V2", "x-qovia-description-zh": "作品的一级评论，按游标翻页，可选按时间倒序（desc，默认）或正序（asc），count 为每页条数。 把上一页返回的 cursor 作为 pcursor 传回即可翻页，has_more 为 false 时停止。回复用 raw.kuaishou.comment_replies_v2 获取。响应较慢（最长约 90 秒）。没有评论时返回空结果，作品不存在时返回 404，均不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:kuaishou", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 500, "usd_per_call": "0.000500", "usd_per_1k": "0.5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.kuaishou.comments_v2/" } }, "/v1/raw/kuaishou/comment_replies_v2": { "get": { "operationId": "raw_kuaishou_comment_replies_v2", "summary": "Kuaishou comment replies V2", "description": "Replies under one first-level comment, cursor-paginated; count is the page size. root_comment_id is the comment_id from raw.kuaishou.comments_v2. Pass the previous page's cursor back as pcursor to continue; stop when has_more is false. Responses are slow (up to about 90 seconds). A comment without replies answers empty and a post or comment that does not exist answers 404; neither is charged.", "tags": [ "Kuaishou" ], "parameters": [ { "name": "photo_id", "in": "query", "required": true, "description": "The post's numeric photo_id", "x-qovia-description-zh": "作品的数字 photo_id", "schema": { "type": "string", "pattern": "^[0-9]{6,25}$", "examples": [ "5220235068916084263" ] }, "example": "5220235068916084263" }, { "name": "root_comment_id", "in": "query", "required": true, "description": "The first-level comment's ID (comment_id from raw.kuaishou.comments_v2)", "x-qovia-description-zh": "一级评论 ID（raw.kuaishou.comments_v2 返回的 comment_id）", "schema": { "type": "string", "pattern": "^[0-9]{1,25}$", "examples": [ "20123456789" ] }, "example": "20123456789" }, { "name": "pcursor", "in": "query", "required": false, "description": "Page cursor; empty for the first page, then the previous page's cursor", "x-qovia-description-zh": "翻页游标；首页留空，之后传上一页返回的 cursor", "schema": { "type": "string", "maxLength": 200, "default": "" } }, { "name": "count", "in": "query", "required": false, "description": "Replies per page", "x-qovia-description-zh": "每页条数", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 10 } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "comment_id": "20123456790", "content": "示例回复", "user_id": "228905803", "nickname": "示例用户", "like_count": 1, "timestamp": 1734081900000 } ], "cursor": "1734081900000", "has_more": true }, "meta": { "billed": true, "charged_usd": "0.000500", "balance_usd": "9.999500", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.kuaishou.comment_replies_v2", "x-qovia-title-zh": "快手评论回复 V2", "x-qovia-description-zh": "某条一级评论下的回复，按游标翻页，count 为每页条数。root_comment_id 取自 raw.kuaishou.comments_v2 返回的 comment_id。把上一页返回的 cursor 作为 pcursor 传回即可翻页，has_more 为 false 时停止。 响应较慢（最长约 90 秒）。没有回复时返回空结果，作品或评论不存在时返回 404，均不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:kuaishou", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 500, "usd_per_call": "0.000500", "usd_per_1k": "0.5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.kuaishou.comment_replies_v2/" } }, "/v1/raw/kuaishou/user": { "get": { "operationId": "raw_kuaishou_user", "summary": "Kuaishou user profile", "description": "A Kuaishou user's public profile by numeric user ID: nickname, bio, avatar, gender, follower / following / post counts. Responses are slow (up to about 90 seconds). A user that does not exist answers 404 and is not charged.", "tags": [ "Kuaishou" ], "parameters": [ { "name": "user_id", "in": "query", "required": true, "description": "The user's numeric ID", "x-qovia-description-zh": "用户的数字 ID", "schema": { "type": "string", "pattern": "^[0-9]{3,20}$", "examples": [ "228905802" ] }, "example": "228905802" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "user_id": "228905802", "nickname": "示例用户", "description": "示例简介", "avatar_url": "https://example.com/avatar.jpg", "gender": "F", "follower_count": 1203400, "following_count": 56, "video_count": 412 }, "meta": { "billed": true, "charged_usd": "0.005000", "balance_usd": "9.995000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.kuaishou.user", "x-qovia-title-zh": "快手用户主页", "x-qovia-description-zh": "用数字用户 ID 查询快手用户主页：昵称、简介、头像、性别、粉丝/关注/作品数等公开资料。 响应较慢（最长约 90 秒）。用户不存在时返回 404，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:kuaishou", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 5000, "usd_per_call": "0.005000", "usd_per_1k": "5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.kuaishou.user/" } }, "/v1/raw/kuaishou/user_videos": { "get": { "operationId": "raw_kuaishou_user_videos", "summary": "Kuaishou user posts", "description": "The posts a user published, cursor-paginated. Pass the previous page's cursor back as pcursor to continue; stop when has_more is false. Responses are slow (up to about 90 seconds). A user without posts answers empty and one that does not exist answers 404; neither is charged.", "tags": [ "Kuaishou" ], "parameters": [ { "name": "user_id", "in": "query", "required": true, "description": "The user's numeric ID", "x-qovia-description-zh": "用户的数字 ID", "schema": { "type": "string", "pattern": "^[0-9]{3,20}$", "examples": [ "228905802" ] }, "example": "228905802" }, { "name": "pcursor", "in": "query", "required": false, "description": "Page cursor; empty for the first page, then the previous page's cursor", "x-qovia-description-zh": "翻页游标；首页留空，之后传上一页返回的 cursor", "schema": { "type": "string", "maxLength": 200, "default": "" } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "photo_id": "5220235068916084263", "caption": "示例作品文案", "play_count": 9258156, "like_count": 536223, "comment_count": 33273, "timestamp": 1734081442000, "cover_url": "https://example.com/cover.jpg" } ], "cursor": "1734081442000", "has_more": true }, "meta": { "billed": true, "charged_usd": "0.005000", "balance_usd": "9.995000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.kuaishou.user_videos", "x-qovia-title-zh": "快手用户作品列表", "x-qovia-description-zh": "某位用户发布的作品列表，按游标翻页。把上一页返回的 cursor 作为 pcursor 传回即可翻页，has_more 为 false 时停止。响应较慢（最长约 90 秒）。没有作品时返回空结果，用户不存在时返回 404，均不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:kuaishou", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 5000, "usd_per_call": "0.005000", "usd_per_1k": "5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.kuaishou.user_videos/" } }, "/v1/raw/kuaishou/user_id_resolve": { "get": { "operationId": "raw_kuaishou_user_id_resolve", "summary": "Kuaishou user ID lookup", "description": "Turns a user's eid (the part of a profile link www.kuaishou.com/profile/, such as 3xyt4gj8p3bqsbu) into the numeric user ID, which raw.kuaishou.user and raw.kuaishou.user_videos take. Responses are slow (up to about 90 seconds). A user that does not exist answers 404 and is not charged.", "tags": [ "Kuaishou" ], "parameters": [ { "name": "eid", "in": "query", "required": true, "description": "The user's eid (from www.kuaishou.com/profile/)", "x-qovia-description-zh": "用户 eid（主页链接 www.kuaishou.com/profile/ 里的部分）", "schema": { "type": "string", "pattern": "^3x[0-9a-z]{10,20}$", "examples": [ "3xyt4gj8p3bqsbu" ] }, "example": "3xyt4gj8p3bqsbu" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "eid": "3xyt4gj8p3bqsbu", "user_id": "228905802" }, "meta": { "billed": true, "charged_usd": "0.000500", "balance_usd": "9.999500", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.kuaishou.user_id_resolve", "x-qovia-title-zh": "快手用户 ID 转换", "x-qovia-description-zh": "把用户的 eid（主页链接 www.kuaishou.com/profile/ 里的部分，如 3xyt4gj8p3bqsbu）换成数字用户 ID， 可接着用于 raw.kuaishou.user 和 raw.kuaishou.user_videos。响应较慢（最长约 90 秒）。用户不存在时返回 404，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:kuaishou", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 500, "usd_per_call": "0.000500", "usd_per_1k": "0.5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.kuaishou.user_id_resolve/" } }, "/v1/raw/bilibili/video": { "get": { "operationId": "raw_bilibili_video", "summary": "Bilibili video detail", "description": "Title, description, uploader, category, tags and engagement (plays, likes, coins, saves, comments, shares, danmaku) for one video. BV ids only; follower counts are not available.", "tags": [ "Bilibili" ], "parameters": [ { "name": "bvid", "in": "query", "required": true, "description": "Video BV ID, e.g. BV1naKB64Evm", "x-qovia-description-zh": "视频 BV 号，例如 BV1naKB64Evm", "schema": { "type": "string", "pattern": "^BV1[1-9A-HJ-NP-Za-km-z]{9}$", "examples": [ "BV1naKB64Evm" ] }, "example": "BV1naKB64Evm" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "id": "soc_bil_9b89815a7ce3", "src": "social", "platform": "bilibili", "lang": "zh-CN", "text": "一口气看懂先进封装：H100、B200、CoWoS与HBM如何连接？\nAI芯片为什么离不开先进封装？…", "author": { "uid_hash": "8fb5730b2ca6", "mid": "1517478075", "name": "坤元Research", "avatar": "https://i0.hdslb.com/bfs/face/8036b7133d5ba1fdc4286353885fdde55f0095dd.jpg" }, "metrics": { "plays": 220502, "likes": 5640, "coins": 3550, "saves": 7982, "comments": 404, "shares": 1558, "danmaku": 242 }, "extra": { "source_id": "BV1naKB64Evm", "url": "https://www.bilibili.com/video/BV1naKB64Evm", "title": "一口气看懂先进封装：H100、B200、CoWoS与HBM如何连接？", "aid": "116944493613065", "cid": "40089160246", "duration_s": 1697, "published_at": "2026-07-19T11:23:00+08:00", "category": { "id": 2103, "name": null }, "tags": [ "先进封装", "CoWoS", "台积电", "HBM", "财经科普" ], "keywords": [ "先进封装", "台积电", "HBM" ], "cover": "https://i1.hdslb.com/bfs/archive/bca0873add82bb7e6c8d7cf2b2e71cea9d18e798.jpg" }, "prov": { "hash": "0xb5092dfcfd4fa826", "ts": "2026-10-20T12:00:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.000500", "balance_usd": "9.999500", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.bilibili.video", "x-qovia-title-zh": "B 站视频详情", "x-qovia-description-zh": "单个视频的标题、简介、UP 主、分区、标签和互动数据（播放、点赞、投币、收藏、评论、分享、弹幕）。只支持 BV 号，不含粉丝数。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:bilibili", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 500, "usd_per_call": "0.000500", "usd_per_1k": "0.5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.bilibili.video/" } }, "/v1/raw/bilibili/search": { "get": { "operationId": "raw_bilibili_search", "summary": "Bilibili video search", "description": "Keyword video search, up to 20 results per page and 50 pages, sortable by plays, publish time, danmaku, saves or comments. Bilibili returns fuzzy matches for any keyword; stop paging when has_more is false (past the last page Bilibili repeats page 1). Results carry no coin or share counts.", "tags": [ "Bilibili" ], "parameters": [ { "name": "keyword", "in": "query", "required": true, "description": "Search keyword", "x-qovia-description-zh": "搜索关键词", "schema": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "\\S", "examples": [ "台积电" ] }, "example": "台积电" }, { "name": "page", "in": "query", "required": false, "description": "Page number; use the cursor returned by the previous page", "x-qovia-description-zh": "页码；用上一页返回的 cursor", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1 } }, { "name": "page_size", "in": "query", "required": false, "description": "Items per page", "x-qovia-description-zh": "每页条数", "schema": { "type": "integer", "minimum": 1, "maximum": 20, "default": 20 } }, { "name": "order", "in": "query", "required": false, "description": "Sort: totalrank relevance (default), click most played, pubdate newest, dm most danmaku, stow most favorited, scores most comments", "x-qovia-description-zh": "排序：totalrank 综合（默认）、click 播放最多、pubdate 最新发布、dm 弹幕最多、stow 收藏最多、scores 评论最多", "schema": { "type": "string", "enum": [ "totalrank", "click", "pubdate", "dm", "stow", "scores" ] } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "id": "soc_bil_2913ac9c522a", "src": "social", "platform": "bilibili", "lang": "zh-CN", "text": "「小白」全球芯片代工王！万字台积电发展史", "author": { "uid_hash": "ca5fa000e345", "mid": "8969156", "name": "小白测评" }, "metrics": { "plays": 689248, "likes": 20365, "saves": 7230, "comments": 1348, "danmaku": 2676 }, "extra": { "source_id": "BV1DkoeYhExZ", "url": "https://www.bilibili.com/video/BV1DkoeYhExZ", "title": "「小白」全球芯片代工王！万字台积电发展史", "published_at": "2025-03-26T18:30:00+08:00", "category": { "id": 95, "name": "数码" }, "tags": [ "芯片", "数码", "台积电", "手机芯片" ], "cover": "https://i0.hdslb.com/bfs/archive/8f62d780e4e308bafa8c9f6c4d14ce5a28b2ce0b.jpg" }, "prov": { "hash": "0xc16f694e973143c1", "ts": "2026-10-20T12:00:00+08:00", "source": "live" } } ], "cursor": 2, "has_more": true }, "meta": { "billed": true, "charged_usd": "0.000500", "balance_usd": "9.999500", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.bilibili.search", "x-qovia-title-zh": "B 站视频搜索", "x-qovia-description-zh": "按关键词搜索视频，每页最多 20 条、最多 50 页，可按播放、发布时间、弹幕、收藏、评论排序。B 站对任何关键词都会给出模糊匹配； has_more 为 false 时请停止翻页（超出末页时 B 站会重复返回第 1 页）。结果不含投币和分享数。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:bilibili", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 500, "usd_per_call": "0.000500", "usd_per_1k": "0.5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.bilibili.search/" } }, "/v1/raw/bilibili/comments": { "get": { "operationId": "raw_bilibili_comments", "summary": "Bilibili video comments", "description": "Top-level comments of a video, hottest first, 20 per page; pass the previous page's cursor back unchanged to continue. Use cid to fetch nested replies. IP location is not available.", "tags": [ "Bilibili" ], "parameters": [ { "name": "bvid", "in": "query", "required": true, "description": "Video BV ID", "x-qovia-description-zh": "视频 BV 号", "schema": { "type": "string", "pattern": "^BV1[1-9A-HJ-NP-Za-km-z]{9}$", "examples": [ "BV1naKB64Evm" ] }, "example": "BV1naKB64Evm" }, { "name": "cursor", "in": "query", "required": false, "description": "The cursor returned by the previous page; omit it for the first page", "x-qovia-description-zh": "上一页返回的 cursor；第一页不传", "schema": { "type": "string", "maxLength": 1024, "default": "" } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "cid": "307039443665", "text": "视频做的形象又专业，大赞。我一个半导体从业人员都得向您学习", "likes": 74, "reply_count": 9, "created_at": "2026-07-21T21:59:05+08:00", "author": { "uid_hash": "38935505d064", "mid": "1025763470", "name": "Xiaobai585" } }, { "cid": "307069093249", "text": "下一代的封装基板应该是玻璃了吧", "likes": 8, "reply_count": 8, "created_at": "2026-07-22T03:47:08+08:00", "author": { "uid_hash": "2e504fc25f56", "mid": "351478085", "name": "青叶竹啊啊啊" } } ], "cursor": "CAESEDE4MzU0ODg3MzI2MzAyNjgiAggB", "has_more": true }, "meta": { "billed": true, "charged_usd": "0.000500", "balance_usd": "9.999500", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.bilibili.comments", "x-qovia-title-zh": "B 站视频评论", "x-qovia-description-zh": "视频的一级评论，按热度排序，每页 20 条；把上一页返回的 cursor 原样传回即可翻页。cid 可用于查询楼中楼回复。不含 IP 属地。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:bilibili", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 500, "usd_per_call": "0.000500", "usd_per_1k": "0.5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.bilibili.comments/" } }, "/v1/raw/bilibili/replies": { "get": { "operationId": "raw_bilibili_replies", "summary": "Bilibili comment replies", "description": "Every nested reply under one top-level comment, in one call (not paginated). Threads with more than about 100 replies may time out, which is not charged.", "tags": [ "Bilibili" ], "parameters": [ { "name": "bvid", "in": "query", "required": true, "description": "Video BV ID", "x-qovia-description-zh": "视频 BV 号", "schema": { "type": "string", "pattern": "^BV1[1-9A-HJ-NP-Za-km-z]{9}$", "examples": [ "BV1dgJS67ETL" ] }, "example": "BV1dgJS67ETL" }, { "name": "root_id", "in": "query", "required": true, "description": "Top-level comment ID (the cid from raw.bilibili.comments)", "x-qovia-description-zh": "一级评论 ID（raw.bilibili.comments 返回的 cid）", "schema": { "type": "integer", "minimum": 1, "examples": [ 317243572785 ] }, "example": 317243572785 } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "cid": "320997789072", "root_cid": "317243572785", "parent_cid": "317243572785", "text": "三星記憶體的淨利是台積電的三倍，只是很難預期三寡頭可以長期維持高獲利…", "likes": 0, "created_at": "2026-10-17T17:40:59+08:00", "author": { "uid_hash": "9a3f92c72f4e", "mid": "320586001", "name": "jay886123" } }, { "cid": "321112269648", "root_cid": "317243572785", "parent_cid": "320997789072", "text": "回复 @jay886123 :你的資訊是不是錯了？", "likes": 0, "created_at": "2026-10-18T17:07:06+08:00", "author": { "uid_hash": "2f280e9c9adb", "mid": "1238965214", "name": "貓界香奈兒" } } ], "cursor": null, "has_more": false, "total": 7 }, "meta": { "billed": true, "charged_usd": "0.000500", "balance_usd": "9.999500", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.bilibili.replies", "x-qovia-title-zh": "B 站评论回复", "x-qovia-description-zh": "一条一级评论下的全部楼中楼回复（一次取完，不分页）。回复很多（约 100 条以上）时可能超时，超时不收费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:bilibili", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 500, "usd_per_call": "0.000500", "usd_per_1k": "0.5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.bilibili.replies/" } }, "/v1/raw/bilibili/danmaku": { "get": { "operationId": "raw_bilibili_danmaku", "summary": "Bilibili danmaku", "description": "Current and historical danmaku of a video's first part, de-duplicated and cut at limit (has_more true means it was cut; raise limit). complete=false means some segments could not be fetched. Older popular videos may time out, which is not charged.", "tags": [ "Bilibili" ], "parameters": [ { "name": "bvid", "in": "query", "required": true, "description": "Video BV ID", "x-qovia-description-zh": "视频 BV 号", "schema": { "type": "string", "pattern": "^BV1[1-9A-HJ-NP-Za-km-z]{9}$", "examples": [ "BV1naKB64Evm" ] }, "example": "BV1naKB64Evm" }, { "name": "limit", "in": "query", "required": false, "description": "Maximum number of danmaku (bullet comments) to return", "x-qovia-description-zh": "最多返回的弹幕条数", "schema": { "type": "integer", "minimum": 1, "maximum": 1000, "default": 200 } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "dmid": "2159472694570373376", "text": "大家快来接盘。", "offset_ms": 40230, "sent_at": "2026-07-20T12:06:45+08:00", "source": "current", "history_date": null }, { "dmid": "2160787288715117312", "text": "这图都错了", "offset_ms": 93908, "sent_at": "2026-07-22T07:38:37+08:00", "source": "current", "history_date": null } ], "cursor": null, "has_more": true, "complete": false }, "meta": { "billed": true, "charged_usd": "0.000500", "balance_usd": "9.999500", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.bilibili.danmaku", "x-qovia-title-zh": "B 站弹幕", "x-qovia-description-zh": "视频第一个分 P 的当前弹幕和历史弹幕，去重后按 limit 截断（has_more 为 true 表示被截断，可调大 limit）。 complete 为 false 表示有分段没取到。发布较久的热门视频可能超时，超时不收费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:bilibili", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 500, "usd_per_call": "0.000500", "usd_per_1k": "0.5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.bilibili.danmaku/" } }, "/v1/raw/bilibili/creator": { "get": { "operationId": "raw_bilibili_creator", "summary": "Bilibili creator profile", "description": "A creator's profile with followers, following, likes (videos, articles and posts together), video count, verification, level, bio and avatar. A user that does not exist answers 404 and is not charged.", "tags": [ "Bilibili" ], "parameters": [ { "name": "mid", "in": "query", "required": true, "description": "The creator's mid (the number in space.bilibili.com/; a video record's author.mid)", "x-qovia-description-zh": "UP 主 mid（空间链接 space.bilibili.com/ 里的数字，即视频记录 author.mid）", "schema": { "type": "string", "pattern": "^[1-9][0-9]{0,18}$", "examples": [ "1517478075" ] }, "example": "1517478075" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "uid_hash": "851c5e9d2289", "name": "坤元Research", "followers": 22562, "total_likes": 15015, "posts": 9, "verified": false, "platform": "bilibili", "mid": "1517478075", "following": 8, "signature": "坤元研究院｜看懂产业的价值流向", "verify_reason": null, "level": 4, "avatar": "https://i0.hdslb.com/bfs/face/8036b7133d5ba1fdc4286353885fdde55f0095dd.jpg", "url": "https://space.bilibili.com/1517478075", "prov": { "hash": "0x1d93aa619b0866ba", "ts": "2026-10-22T00:00:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.bilibili.creator", "x-qovia-title-zh": "B 站 UP 主资料", "x-qovia-description-zh": "UP 主主页资料：粉丝数、关注数、获赞数（视频、专栏和动态累计）、投稿视频数、认证信息、等级、签名和头像。 用户不存在时返回 404，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:bilibili", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.bilibili.creator/" } }, "/v1/raw/bilibili/creator_videos": { "get": { "operationId": "raw_bilibili_creator_videos", "summary": "Bilibili creator videos", "description": "Videos a creator uploaded, newest, most played or most saved first, up to 50 a page and 100 pages; same ids as video detail, with play, comment and danmaku counts (no likes, coins, saves or shares). Use the previous page's cursor as page to continue; stop when has_more is false. A creator without videos, or one that does not exist, answers empty and is not charged.", "tags": [ "Bilibili" ], "parameters": [ { "name": "mid", "in": "query", "required": true, "description": "The creator's mid", "x-qovia-description-zh": "UP 主 mid", "schema": { "type": "string", "pattern": "^[1-9][0-9]{0,18}$", "examples": [ "1517478075" ] }, "example": "1517478075" }, { "name": "page", "in": "query", "required": false, "description": "Page number; use the cursor returned by the previous page", "x-qovia-description-zh": "页码；用上一页返回的 cursor", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 1 } }, { "name": "page_size", "in": "query", "required": false, "description": "Items per page", "x-qovia-description-zh": "每页条数", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 25 } }, { "name": "order", "in": "query", "required": false, "description": "Order: pubdate newest (the default), click most played, stow most saved", "x-qovia-description-zh": "排序：pubdate 最新发布（默认）、click 最多播放、stow 最多收藏", "schema": { "type": "string", "enum": [ "pubdate", "click", "stow" ], "default": "pubdate" } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "id": "soc_bil_bdb3bc6cddd2", "src": "social", "platform": "bilibili", "lang": "zh-CN", "text": "高阶HDI化，正在重塑PCB产业格局\n从智能手表等AI终端，到英伟达AI服务器和光模块，为什么越来越多的设备开始采用高阶HDI？ \n与传统PCB相比，HDI究竟解决了什么技术难题？…", "author": { "uid_hash": "851c5e9d2289", "mid": "1517478075", "name": "坤元Research" }, "metrics": { "plays": 4696, "comments": 10, "danmaku": 1 }, "extra": { "source_id": "BV1oeJX6bELV", "url": "https://www.bilibili.com/video/BV1oeJX6bELV", "title": "高阶HDI化，正在重塑PCB产业格局", "aid": "117449638944356", "duration_s": 636, "published_at": "2026-10-16T16:30:10+08:00", "category": { "id": 231, "name": null }, "cover": "https://i0.hdslb.com/bfs/archive/dbfb60105a77a928b19bd3f5519970ddf00f187a.jpg" }, "prov": { "hash": "0xc91a1c6a84576b38", "ts": "2026-10-22T00:00:00+08:00", "source": "live" } }, { "id": "soc_bil_c1ebaf32d311", "src": "social", "platform": "bilibili", "lang": "zh-CN", "text": "看懂玻璃封装基板的产业逻辑和价值流向\nAI芯片越做越大，传统有机封装基板开始撑不住了，玻璃基板正在成为下一代先进封装的重要方向。\n这期我们从最底层的工艺讲清楚：为什么是玻璃？TGV…", "author": { "uid_hash": "851c5e9d2289", "mid": "1517478075", "name": "坤元Research" }, "metrics": { "plays": 29270, "comments": 103, "danmaku": 10 }, "extra": { "source_id": "BV18Sh16xEPX", "url": "https://www.bilibili.com/video/BV18Sh16xEPX", "title": "看懂玻璃封装基板的产业逻辑和价值流向", "aid": "117331930059084", "duration_s": 830, "published_at": "2026-09-25T21:34:21+08:00", "category": { "id": 231, "name": null }, "cover": "https://i2.hdslb.com/bfs/archive/85db5326e9f02da3d504580cdc2a1ddcbbd70179.jpg" }, "prov": { "hash": "0xefe766f0060f1577", "ts": "2026-10-22T00:00:00+08:00", "source": "live" } } ], "cursor": 2, "has_more": true, "total": 9 }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.bilibili.creator_videos", "x-qovia-title-zh": "B 站 UP 主投稿视频", "x-qovia-description-zh": "一个 UP 主投稿的视频，可按最新发布、最多播放或最多收藏排序，每页最多 50 条、最多 100 页；记录与视频详情同一 id， 含播放、评论和弹幕数（不含点赞、投币、收藏和分享）。用上一页返回的 cursor 作为 page 翻页，has_more 为 false 时停止。 没有投稿或用户不存在时返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:bilibili", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.bilibili.creator_videos/" } }, "/v1/raw/bilibili/popular": { "get": { "operationId": "raw_bilibili_popular", "summary": "Bilibili popular videos", "description": "Bilibili's popular videos, 20 a page, as the same records as video detail (same ids) with plays, likes, coins, saves, comments, shares and danmaku. Use the previous page's cursor as page to continue; stop when has_more is false.", "tags": [ "Bilibili" ], "parameters": [ { "name": "page", "in": "query", "required": false, "description": "Page number; use the cursor returned by the previous page", "x-qovia-description-zh": "页码；用上一页返回的 cursor", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1 } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "id": "soc_bil_11760c9b62a2", "src": "social", "platform": "bilibili", "lang": "zh-CN", "text": "折1万次，会坏吗？iPhone Duo深度评测\n相信各位和我们一样，对苹果的第一台折叠屏手机充满了好奇，这次我们为iPhone Duo准备了一系列特别的测试，甚至专门准备了一台能够…", "author": { "uid_hash": "bdecfe51a931", "mid": "946974", "name": "影视飓风", "avatar": "https://i0.hdslb.com/bfs/face/c1733474892caa45952b2c09a89323157df7129a.jpg" }, "metrics": { "plays": 662143, "likes": 66418, "coins": 37011, "saves": 15064, "comments": 10201, "shares": 9252, "danmaku": 13953 }, "extra": { "source_id": "BV1xrnz6gEVD", "url": "https://www.bilibili.com/video/BV1xrnz6gEVD", "title": "折1万次，会坏吗？iPhone Duo深度评测", "aid": "117478344627500", "cid": "42926145926", "duration_s": 1492, "published_at": "2026-10-21T20:00:00+08:00", "category": { "id": 95, "name": "数码" }, "cover": "https://i0.hdslb.com/bfs/archive/ccacc1c956715cf06db7a29b634c3c269654acea.jpg" }, "prov": { "hash": "0xdb0742074c1745b4", "ts": "2026-10-22T00:00:00+08:00", "source": "live" } }, { "id": "soc_bil_7127530b3a6c", "src": "social", "platform": "bilibili", "lang": "zh-CN", "text": "《南屏晚钟》来啦！\n大家晚上好，今天唱《南屏晚钟》 。\n还没等到我回复的新朋友们不要伤心和失望呀！\n平时白天忙一些，晚上时间就充裕啦～\n吃完晚饭我来回大家评论哟！\n再次感谢每一位朋…", "author": { "uid_hash": "c1a05d0a77c8", "mid": "249082219", "name": "李诺Noomi", "avatar": "https://i1.hdslb.com/bfs/face/3ccca3980dedd3dc44b2814c5ddc176b7db6b7f4.jpg" }, "metrics": { "plays": 1305495, "likes": 87053, "coins": 10746, "saves": 15013, "comments": 5192, "shares": 2603, "danmaku": 481 }, "extra": { "source_id": "BV1mgnP6yELh", "url": "https://www.bilibili.com/video/BV1mgnP6yELh", "title": "《南屏晚钟》来啦！", "aid": "117472741165711", "cid": "42898752711", "duration_s": 97, "published_at": "2026-10-20T18:25:41+08:00", "category": { "id": 31, "name": "翻唱" }, "cover": "https://i1.hdslb.com/bfs/archive/6e7a970e4f679969853d80f8154b6ccb3d3a5b48.jpg" }, "prov": { "hash": "0x8facacbe7099267f", "ts": "2026-10-22T00:00:00+08:00", "source": "live" } } ], "cursor": 2, "has_more": true }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.bilibili.popular", "x-qovia-title-zh": "B 站综合热门", "x-qovia-description-zh": "B 站综合热门视频，每页 20 条，记录与视频详情相同（同一 id），含播放、点赞、投币、收藏、评论、分享和弹幕数。 用上一页返回的 cursor 作为 page 翻页，has_more 为 false 时停止。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:bilibili", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.bilibili.popular/" } }, "/v1/raw/xingtu/author": { "get": { "operationId": "raw_xingtu_author", "summary": "Douyin Xingtu creator profile", "description": "Xingtu creator profile: nickname, followers, gender, location, the matching Douyin uid / sec_uid / handle, MCN, content labels, Xingtu and e-commerce status. Unknown author ids answer 404 and are not charged.", "tags": [ "Douyin Xingtu" ], "parameters": [ { "name": "author_id", "in": "query", "required": true, "description": "Xingtu creator ID (o_author_id)", "x-qovia-description-zh": "星图作者 ID（o_author_id）", "schema": { "type": "string", "pattern": "^[0-9]{15,20}$", "examples": [ "6790158034132795406" ] }, "example": "6790158034132795406" }, { "name": "channel", "in": "query", "required": false, "description": "1 short video, 10 live streaming", "x-qovia-description-zh": "1 短视频，10 直播", "schema": { "type": "string", "enum": [ "1", "10" ], "default": "1" } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "id": "soc_xin_a890182a3d8f", "src": "social", "platform": "xingtu", "author_id": "6790158034132795406", "nickname": "犟种兄弟", "avatar_url": "https://p11.douyinpic.com/aweme/1080x1080/aweme-avatar/tos-cn-avt-0015_b5cd790831737f84254c5a5cb4ca0fd6.jpeg", "followers": 2737562, "gender": "male", "location": { "province": "辽宁省", "city": "沈阳市" }, "douyin": { "uid": "2422960710762380", "sec_uid": "MS4wLjABAAAATBkQ-V3vn_LrvOI7cYOZ7pDNihy7fSR0HZTF8dzJcomEi9X3YQCfyb4BzUO8W8aD", "unique_id": "Xiaomengzaizhene", "short_id": "3040643096" }, "mcn": { "id": "7091111787000496139", "name": "忠新影视" }, "content_labels": [ "搞笑剧情", "剧情反转", "陈翔短剧" ], "tags": [ { "tag": "剧情搞笑", "subtags": [ "剧情" ] } ], "is_star": true, "ecommerce_enabled": true, "channels": [ 1 ], "joined_at": "2020-02-06T10:41:05+08:00", "prov": { "hash": "0x751265002a285a8c", "ts": "2026-10-20T12:00:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.xingtu.author", "x-qovia-title-zh": "抖音星图达人资料", "x-qovia-description-zh": "星图达人主页基本信息：昵称、粉丝数、性别、地区、对应的抖音 uid / sec_uid / 抖音号、MCN、内容标签、 是否星图达人、是否开通电商。作者 ID 不存在时返回 404，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:xingtu", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.xingtu.author/" } }, "/v1/raw/xingtu/author_videos": { "get": { "operationId": "raw_xingtu_author_videos", "summary": "Douyin Xingtu creator recent videos", "description": "A creator's latest personal and Xingtu (sponsored) videos, up to 15 each, with plays, likes, comments and shares, plus a summary of recent interaction rate, median plays and view rate against peers (keys ending in _enrollment cover Xingtu videos). Unknown authors answer 404 and creators without videos answer empty; neither is charged.", "tags": [ "Douyin Xingtu" ], "parameters": [ { "name": "author_id", "in": "query", "required": true, "description": "Xingtu creator ID (o_author_id)", "x-qovia-description-zh": "星图作者 ID（o_author_id）", "schema": { "type": "string", "pattern": "^[0-9]{15,20}$", "examples": [ "6790158034132795406" ] }, "example": "6790158034132795406" }, { "name": "only_assign", "in": "query", "required": false, "description": "When true, Xingtu videos cover assigned orders only", "x-qovia-description-zh": "true 时星图视频只看指派订单", "schema": { "type": "boolean", "default": false } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "id": "soc_xin_892124ba9175", "src": "social", "platform": "xingtu", "lang": "zh-CN", "text": "蒙哥，老师以后跟你各论各的", "author": { "author_id": "6790158034132795406", "douyin_uid": "2422960710762380", "name": null, "followers": null }, "metrics": { "plays": 5000740, "likes": 200204, "comments": 1329, "shares": 14800 }, "extra": { "source_id": "7674181083131054406", "published_at": "2026-08-15T17:02:03+08:00", "duration_s": 249, "is_hot": false, "is_star_video": false, "url": "https://www.douyin.com/video/7674181083131054406" }, "prov": { "hash": "0xf46ca3820c6362d2", "ts": "2026-10-20T12:00:00+08:00", "source": "live" } } ], "cursor": null, "has_more": false, "author_id": "6790158034132795406", "summary": { "interaction": { "rate": 0.0768, "compare_avg": 0.0239, "compare_author": 0.81 }, "interaction_enrollment": { "rate": 0.0601, "compare_avg": -0.0205, "compare_author": 0.59 }, "play_medium": { "rate": 409298, "compare_avg": 25.8, "compare_author": 0.98 }, "play_medium_enrollment": { "rate": 1790337, "compare_avg": 40.3, "compare_author": 0.98 }, "video_view_rate": { "rate": 0.2339, "compare_avg": 0.0834, "compare_author": 0.83 }, "video_view_rate_enrollment": { "rate": 0.2167, "compare_avg": 0.0953, "compare_author": 0.85 } } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.xingtu.author_videos", "x-qovia-title-zh": "抖音星图达人近期作品", "x-qovia-description-zh": "达人最近的个人视频和星图（商单）视频，各最多 15 条，含播放、点赞、评论、分享，以及近期互动率、播放中位数、 完播率与同类达人的对比（summary，enrollment 结尾的是星图视频）。作者不存在时返回 404，没有作品时返回空结果， 均不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:xingtu", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.xingtu.author_videos/" } }, "/v1/raw/xingtu/author_spread": { "get": { "operationId": "raw_xingtu_author_spread", "summary": "Douyin Xingtu creator reach overview", "description": "Reach overview for the last 30 or 90 days: video count, average likes/comments/shares, interaction rate, completion rate, median plays and the share of peers beaten, plus CPM/CPE estimates. Rates are Xingtu's basis-point integers (528 = 5.28%); expect_cpm, expect_cpe and sales_expect_cpm are in CNY cents. A window without videos answers empty (estimates only) and is not charged.", "tags": [ "Douyin Xingtu" ], "parameters": [ { "name": "author_id", "in": "query", "required": true, "description": "Xingtu creator ID (o_author_id)", "x-qovia-description-zh": "星图作者 ID（o_author_id）", "schema": { "type": "string", "pattern": "^[0-9]{15,20}$", "examples": [ "6790158034132795406" ] }, "example": "6790158034132795406" }, { "name": "video_type", "in": "query", "required": false, "description": "1 personal videos, 2 Xingtu (sponsored) videos", "x-qovia-description-zh": "1 个人视频，2 星图视频", "schema": { "type": "integer", "enum": [ 1, 2 ], "default": 1 } }, { "name": "range", "in": "query", "required": false, "description": "2 last 30 days, 3 last 90 days", "x-qovia-description-zh": "2 近 30 天，3 近 90 天", "schema": { "type": "integer", "enum": [ 2, 3 ], "default": 2 } }, { "name": "only_assign", "in": "query", "required": false, "description": "Only with video_type=2: assigned orders only", "x-qovia-description-zh": "仅 video_type=2 时生效：只看指派订单", "schema": { "type": "boolean", "default": false } }, { "name": "flow_type", "in": "query", "required": false, "description": "Only with video_type=2: 1 excludes ad traffic", "x-qovia-description-zh": "仅 video_type=2 时生效：1 排除广告流量", "schema": { "type": "integer", "enum": [ 0, 1 ], "default": 0 } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "id": "soc_xin_7d90c97f0782", "src": "social", "platform": "xingtu", "author_id": "6790158034132795406", "videos": 7, "avg_duration": 25556, "avg_likes": 54259, "avg_comments": 310, "avg_shares": 11408, "interact_rate": { "value": 528, "overtake": 8620 }, "play_over_rate": { "value": 1055, "overtake": 6673 }, "play_median": { "value": 1311912, "overtake": 9003 }, "play_stability": null, "expect_cpm": { "cpm_21_60": 1192, "cpm_60": 1315 }, "expect_cpe": { "cpe_21_60": 28, "cpe_60": 31 }, "sales_expect_cpm": { "cpm_21_60": 1546, "cpm_60": 1705 }, "prov": { "hash": "0x3e8e11d0cd112e6c", "ts": "2026-10-20T12:00:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.xingtu.author_spread", "x-qovia-title-zh": "抖音星图达人传播表现", "x-qovia-description-zh": "近 30 或 90 天的视频传播概览：作品数、平均点赞/评论/分享、互动率、完播率、播放中位数及超过同类达人的比例， 外加预估 CPM/CPE。比率类字段按星图原值输出（万分比整数，528 表示 5.28%）；expect_cpm、expect_cpe、 sales_expect_cpm 的单位是分。窗口内没有作品时返回空结果（只剩报价预估），不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:xingtu", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.xingtu.author_spread/" } }, "/v1/raw/xingtu/author_pricing": { "get": { "operationId": "raw_xingtu_author_pricing", "summary": "Douyin Xingtu creator rate card", "description": "A creator's Xingtu rate card (integrated video, custom video and so on, in CNY, with list price, settlement type and whether it is open) and industry tags. Creators without any price answer empty and are not charged.", "tags": [ "Douyin Xingtu" ], "parameters": [ { "name": "author_id", "in": "query", "required": true, "description": "Xingtu creator ID (o_author_id)", "x-qovia-description-zh": "星图作者 ID（o_author_id）", "schema": { "type": "string", "pattern": "^[0-9]{15,20}$", "examples": [ "6790158034132795406" ] }, "example": "6790158034132795406" }, { "name": "channel", "in": "query", "required": false, "description": "1 short video, 10 live streaming", "x-qovia-description-zh": "1 短视频，10 直播", "schema": { "type": "string", "enum": [ "1", "10" ], "default": "1" } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "id": "soc_xin_e273f03d7b93", "src": "social", "platform": "xingtu", "author_id": "6790158034132795406", "prices": [ { "field": "long_video_price", "desc": "植入视频", "price": 87000, "origin_price": 87000, "settlement_desc": "固定价格", "video_type": 2, "is_open": true }, { "field": "price", "desc": "定制视频", "price": 96000, "origin_price": 96000, "settlement_desc": "固定价格", "video_type": 71, "is_open": true } ], "industry_tags": [ "生活服务-二手交易", "互联网电商服务-综合电商平台" ], "prov": { "hash": "0x8b8d66b574df7754", "ts": "2026-10-20T12:00:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.010000", "balance_usd": "9.990000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.xingtu.author_pricing", "x-qovia-title-zh": "抖音星图达人报价", "x-qovia-description-zh": "达人在星图上的合作报价（植入视频、定制视频等，单位人民币元，含原价、结算方式、是否开放）和行业标签。 没有任何报价时返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:xingtu", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 10000, "usd_per_call": "0.010000", "usd_per_1k": "10" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.xingtu.author_pricing/" } }, "/v1/raw/xingtu/author_audience": { "get": { "operationId": "raw_xingtu_author_audience", "summary": "Douyin Xingtu creator viewer profile", "description": "Who watches the creator's videos: distributions by device brand, city tier, age, city, province, gender, consumer segment and interest, each with Xingtu's one-line summary and per-bucket counts. Creators without a profile answer empty and are not charged.", "tags": [ "Douyin Xingtu" ], "parameters": [ { "name": "author_id", "in": "query", "required": true, "description": "Xingtu creator ID (o_author_id)", "x-qovia-description-zh": "星图作者 ID（o_author_id）", "schema": { "type": "string", "pattern": "^[0-9]{15,20}$", "examples": [ "6790158034132795406" ] }, "example": "6790158034132795406" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "id": "soc_xin_5cbca277db81", "src": "social", "platform": "xingtu", "author_id": "6790158034132795406", "dimensions": [ { "type": 2, "name": "年龄分布", "summary": "18到23岁居多,占比46%", "buckets": [ { "key": "18-23", "value": 506224 }, { "key": "24-30", "value": 178006 } ] }, { "type": 32, "name": "城市等级分布", "summary": "一线居多,占比24%", "buckets": [ { "key": "一线", "value": 421298 }, { "key": "三线", "value": 414508 } ] } ], "updated_at": "2026-10-20T12:11:12+08:00", "prov": { "hash": "0x781dafa0a4b1ecaf", "ts": "2026-10-20T12:00:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.010000", "balance_usd": "9.990000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.xingtu.author_audience", "x-qovia-title-zh": "抖音星图达人观众画像", "x-qovia-description-zh": "观看过达人视频的观众画像：设备品牌、城市等级、年龄、城市、省份、性别、八大人群、兴趣等分布，每个维度给出 星图的一句话结论和各分桶人数。没有画像数据时返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:xingtu", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 10000, "usd_per_call": "0.010000", "usd_per_1k": "10" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.xingtu.author_audience/" } }, "/v1/raw/xingtu/author_fans": { "get": { "operationId": "raw_xingtu_author_fans", "summary": "Douyin Xingtu creator follower profile", "description": "Profile of a creator's followers (or fan club, or loyal fans): age, gender, consumer segment, device brand, interests and more, in the same shape as the viewer profile. Creators without a profile answer empty and are not charged.", "tags": [ "Douyin Xingtu" ], "parameters": [ { "name": "author_id", "in": "query", "required": true, "description": "Xingtu creator ID (o_author_id)", "x-qovia-description-zh": "星图作者 ID（o_author_id）", "schema": { "type": "string", "pattern": "^[0-9]{15,20}$", "examples": [ "6790158034132795406" ] }, "example": "6790158034132795406" }, { "name": "crowd", "in": "query", "required": false, "description": "1 followers, 2 fan club members, 5 loyal fans", "x-qovia-description-zh": "1 粉丝，2 粉丝团，5 铁粉", "schema": { "type": "integer", "enum": [ 1, 2, 5 ], "default": 1 } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "id": "soc_xin_219d1e8dee5d", "src": "social", "platform": "xingtu", "author_id": "6790158034132795406", "dimensions": [ { "type": 1, "name": "性别分布", "summary": "男性居多,占比74%", "buckets": [ { "key": "female", "value": 709830 }, { "key": "male", "value": 2024415 } ] } ], "updated_at": "2026-10-20T12:11:18+08:00", "prov": { "hash": "0x4d248318aefe3f95", "ts": "2026-10-20T12:00:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.010000", "balance_usd": "9.990000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.xingtu.author_fans", "x-qovia-title-zh": "抖音星图达人粉丝画像", "x-qovia-description-zh": "达人粉丝（或粉丝团、铁粉）的画像：年龄、性别、八大人群、设备品牌、兴趣等分布，结构与观众画像相同。 没有画像数据时返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:xingtu", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 10000, "usd_per_call": "0.010000", "usd_per_1k": "10" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.xingtu.author_fans/" } }, "/v1/raw/xingtu/author_seeding": { "get": { "operationId": "raw_xingtu_author_seeding", "summary": "Douyin Xingtu creator search lift", "description": "Search lift after viewers watch the creator: average searches after viewing, search-after-view rate and search-term CTR. Xingtu only publishes display values (such as \"<10\" or \"1%\"), returned as strings. Creators without data answer empty and are not charged.", "tags": [ "Douyin Xingtu" ], "parameters": [ { "name": "author_id", "in": "query", "required": true, "description": "Xingtu creator ID (o_author_id)", "x-qovia-description-zh": "星图作者 ID（o_author_id）", "schema": { "type": "string", "pattern": "^[0-9]{15,20}$", "examples": [ "6790158034132795406" ] }, "example": "6790158034132795406" }, { "name": "range", "in": "query", "required": false, "description": "Window: the last 30 or 90 days", "x-qovia-description-zh": "统计窗口：近 30 或 90 天", "schema": { "type": "string", "enum": [ "30", "90" ], "default": "30" } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "id": "soc_xin_60f93f1bf1ec", "src": "social", "platform": "xingtu", "author_id": "6790158034132795406", "search_after_view_count": "<10", "search_after_view_rate": "<0.02%", "search_word_ctr": "1%", "updated_at": "2026-10-19T13:25:27+08:00", "prov": { "hash": "0xefabc428dcb28200", "ts": "2026-10-20T12:00:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.010000", "balance_usd": "9.990000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.xingtu.author_seeding", "x-qovia-title-zh": "抖音星图达人种草价值", "x-qovia-description-zh": "种草价值：看过达人视频后的平均搜索次数、看后搜索率和搜索词点击率。星图只给展示值（如\"<10\"、\"1%\"）， 原样以字符串输出。没有数据时返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:xingtu", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 10000, "usd_per_call": "0.010000", "usd_per_1k": "10" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.xingtu.author_seeding/" } }, "/v1/raw/xingtu/author_cpm": { "get": { "operationId": "raw_xingtu_author_cpm", "summary": "Douyin Xingtu creator CPM and CPE", "description": "Cost per thousand plays (CPM) and per engagement (CPE) at the current rate card, for 20-60 s and 60 s+ videos, in CNY; cpm_20_60_rank_percent is the peer percentile, views the expected plays, and sn_ fields are Xingtu's alternative basis. Creators without data answer empty and are not charged.", "tags": [ "Douyin Xingtu" ], "parameters": [ { "name": "author_id", "in": "query", "required": true, "description": "Xingtu creator ID (o_author_id)", "x-qovia-description-zh": "星图作者 ID（o_author_id）", "schema": { "type": "string", "pattern": "^[0-9]{15,20}$", "examples": [ "6790158034132795406" ] }, "example": "6790158034132795406" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "id": "soc_xin_6cfc4e263819", "src": "social", "platform": "xingtu", "author_id": "6790158034132795406", "cpm_20_60": 11.924, "cpm_60": 13.1576, "cpe_20_60": 0.2819, "cpe_60": 0.3111, "cpm_20_60_rank_percent": 0.0406, "sn_cpm_20_60": 11.924, "sn_cpm_60": 13.1576, "sn_cpe_20_60": 0.2831, "sn_cpe_60": 0.3124, "views": 7296186, "sn_views": 7296186, "updated_at": "2026-10-19T22:34:11+08:00", "prov": { "hash": "0x3b23a176cfd0e8a3", "ts": "2026-10-20T12:00:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.010000", "balance_usd": "9.990000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.xingtu.author_cpm", "x-qovia-title-zh": "抖音星图达人 CPM/CPE", "x-qovia-description-zh": "按当前报价估算的千次播放成本（CPM）和单次互动成本（CPE），分 20-60 秒与 60 秒以上视频，单位人民币元； cpm_20_60_rank_percent 为同类排名百分位，views 为预估播放量，sn_ 前缀为星图给出的另一口径。 没有数据时返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:xingtu", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 10000, "usd_per_call": "0.010000", "usd_per_1k": "10" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.xingtu.author_cpm/" } }, "/v1/raw/xingtu/author_indices": { "get": { "operationId": "raw_xingtu_author_indices", "summary": "Douyin Xingtu creator business indices", "description": "Xingtu's business indices (cooperation, cost-performance, conversion, shopping, spread and star), each with score, peer average, rank, rank percentile and period-over-period change. Creators without data answer empty and are not charged.", "tags": [ "Douyin Xingtu" ], "parameters": [ { "name": "author_id", "in": "query", "required": true, "description": "Xingtu creator ID (o_author_id)", "x-qovia-description-zh": "星图作者 ID（o_author_id）", "schema": { "type": "string", "pattern": "^[0-9]{15,20}$", "examples": [ "6790158034132795406" ] }, "example": "6790158034132795406" }, { "name": "industry_tag", "in": "query", "required": false, "description": "Industry tag ID; 0 for all industries", "x-qovia-description-zh": "行业标签 ID，0 为全部行业", "schema": { "type": "integer", "minimum": 0, "default": 0 } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "id": "soc_xin_06c43a95c3b9", "src": "social", "platform": "xingtu", "author_id": "6790158034132795406", "indices": { "cooperate_index": { "value": 75.64, "avg_value": 75.55, "rank": 147221, "rank_percent": 0.0674, "relative_ratio": 0 }, "cp_index": { "value": 69.97, "avg_value": 64.09, "rank": 27040, "rank_percent": 0.0124, "relative_ratio": 0 }, "link_convert_index": { "value": 61.51, "avg_value": 55.24, "rank": 174328, "rank_percent": 0.0798, "relative_ratio": -0.0956 }, "link_shopping_index": { "value": 71.76, "avg_value": 53.24, "rank": 68468, "rank_percent": 0.0313, "relative_ratio": 0.1617 }, "link_spread_index": { "value": 71.62, "avg_value": 53.09, "rank": 69171, "rank_percent": 0.0317, "relative_ratio": 0.15 }, "link_star_index": { "value": 70.1, "avg_value": 56.19, "rank": 51681, "rank_percent": 0.0236, "relative_ratio": 0.0381 } }, "prov": { "hash": "0x3efa5d92ce5c7227", "ts": "2026-10-20T12:00:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.010000", "balance_usd": "9.990000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.xingtu.author_indices", "x-qovia-title-zh": "抖音星图达人商业指数", "x-qovia-description-zh": "星图商业能力指数：合作指数、性价比指数、转化指数、种草指数、传播指数、星图指数，每项给出分值、同类均值、 排名、排名百分位和环比。没有数据时返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:xingtu", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 10000, "usd_per_call": "0.010000", "usd_per_1k": "10" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.xingtu.author_indices/" } }, "/v1/raw/xingtu/author_conversion": { "get": { "operationId": "raw_xingtu_author_conversion", "summary": "Douyin Xingtu creator conversion", "description": "Conversion value of the creator's Xingtu videos: median plays, related video count, and display ranges for cost per click, component clicks, component click rate, average sales, GPM and recommended product price (null when Xingtu has none). Creators without any data answer empty and are not charged.", "tags": [ "Douyin Xingtu" ], "parameters": [ { "name": "author_id", "in": "query", "required": true, "description": "Xingtu creator ID (o_author_id)", "x-qovia-description-zh": "星图作者 ID（o_author_id）", "schema": { "type": "string", "pattern": "^[0-9]{15,20}$", "examples": [ "6790158034132795406" ] }, "example": "6790158034132795406" }, { "name": "range", "in": "query", "required": false, "description": "1 last 7 days, 2 last 30 days, 3 last 90 days", "x-qovia-description-zh": "1 近 7 天，2 近 30 天，3 近 90 天", "schema": { "type": "integer", "enum": [ 1, 2, 3 ], "default": 2 } }, { "name": "industry_id", "in": "query", "required": false, "description": "Industry ID; 0 for all industries", "x-qovia-description-zh": "行业 ID，0 为全部行业", "schema": { "type": "integer", "minimum": 0, "default": 0 } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "id": "soc_xin_3fe1366eef66", "src": "social", "platform": "xingtu", "author_id": "6790158034132795406", "video_plays_median": 771476, "related_videos": 2, "related_cpc_range": "16-18", "component_click_count_range": "500以下", "component_click_rate_range": "2%以下", "avg_sales_amount_range": null, "gpm_range": null, "product_price_range": null, "prov": { "hash": "0x1932de56b52bf9b7", "ts": "2026-10-20T12:00:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.010000", "balance_usd": "9.990000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.xingtu.author_conversion", "x-qovia-title-zh": "抖音星图达人转化能力", "x-qovia-description-zh": "星图短视频的转化价值：播放中位数、关联视频数，以及单次点击成本、组件点击量、组件点击率、平均销售额、GPM、 推荐商品价格等区间（星图只给展示区间，无数据为 null）。没有任何数据时返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:xingtu", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 10000, "usd_per_call": "0.010000", "usd_per_1k": "10" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.xingtu.author_conversion/" } }, "/v1/raw/xingtu/author_content_keywords": { "get": { "operationId": "raw_xingtu_author_content_keywords", "summary": "Douyin Xingtu creator content keywords", "description": "The most frequent words in a creator's recent videos (about 20), sorted by count; videos is the number of videos containing the word (null when Xingtu does not say). Creators without keywords answer empty and are not charged.", "tags": [ "Douyin Xingtu" ], "parameters": [ { "name": "author_id", "in": "query", "required": true, "description": "Xingtu creator ID (o_author_id)", "x-qovia-description-zh": "星图作者 ID（o_author_id）", "schema": { "type": "string", "pattern": "^[0-9]{15,20}$", "examples": [ "6790158034132795406" ] }, "example": "6790158034132795406" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "id": "soc_xin_a016353f7ecf", "src": "social", "platform": "xingtu", "author_id": "6790158034132795406", "keywords": [ { "word": "学校", "count": 10, "videos": 5 }, { "word": "老师", "count": 6, "videos": 6 }, { "word": "便宜", "count": 4, "videos": null } ], "prov": { "hash": "0x78cdb1180c725388", "ts": "2026-10-20T12:00:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.000500", "balance_usd": "9.999500", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.xingtu.author_content_keywords", "x-qovia-title-zh": "抖音星图达人内容热词", "x-qovia-description-zh": "达人近期作品内容中的高频词（约 20 个），按出现次数从高到低排列，videos 为包含该词的作品数（星图未给出时为 null）。没有热词时返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:xingtu", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 500, "usd_per_call": "0.000500", "usd_per_1k": "0.5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.xingtu.author_content_keywords/" } }, "/v1/raw/xingtu/author_comment_keywords": { "get": { "operationId": "raw_xingtu_author_comment_keywords", "summary": "Douyin Xingtu creator comment keywords", "description": "Hot words in the comments under a Xingtu creator's videos, with Xingtu's hot_rate passed through as is. No keywords answers an empty result and is not charged.", "tags": [ "Douyin Xingtu" ], "parameters": [ { "name": "author_id", "in": "query", "required": true, "description": "Xingtu creator ID (o_author_id)", "x-qovia-description-zh": "星图作者 ID（o_author_id）", "schema": { "type": "string", "pattern": "^[0-9]{15,20}$", "examples": [ "6790158034132795406" ] }, "example": "6790158034132795406" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "id": "soc_xin_738d17898c68", "src": "social", "platform": "xingtu", "author_id": "6790158034132795406", "keywords": [ { "word": "老师", "hot_rate": 1107 }, { "word": "学校", "hot_rate": 521 }, { "word": "时候", "hot_rate": 505 } ], "prov": { "hash": "0x8053a5a59be79c94", "ts": "2026-10-20T12:00:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.000500", "balance_usd": "9.999500", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.xingtu.author_comment_keywords", "x-qovia-title-zh": "抖音星图达人评论热词", "x-qovia-description-zh": "星图统计的达人视频评论区热词及其热度值（hot_rate，按星图原值透传）。没有热词时返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:xingtu", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 500, "usd_per_call": "0.000500", "usd_per_1k": "0.5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.xingtu.author_comment_keywords/" } }, "/v1/raw/xingtu/video_report": { "get": { "operationId": "raw_xingtu_video_report", "summary": "Douyin Xingtu video report", "description": "Xingtu's report for one Douyin video: plays, likes, comments, shares, saves, interactions, interaction rate, completion rate, content labels and music, plus the author's Xingtu id, Douyin uid, name and followers. Videos Xingtu does not know answer 404 and are not charged.", "tags": [ "Douyin Xingtu" ], "parameters": [ { "name": "item_id", "in": "query", "required": true, "description": "Douyin video ID (aweme_id)", "x-qovia-description-zh": "抖音作品 ID（aweme_id）", "schema": { "type": "string", "pattern": "^[0-9]{15,20}$", "examples": [ "7674181083131054406" ] }, "example": "7674181083131054406" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "id": "soc_xin_892124ba9175", "src": "social", "platform": "xingtu", "lang": "zh-CN", "text": "蒙哥，老师以后跟你各论各的", "author": { "author_id": "6790158034132795406", "douyin_uid": "2422960710762380", "name": "犟种兄弟", "followers": 2737562 }, "metrics": { "plays": 5000740, "likes": 200204, "comments": 1329, "shares": 14800, "saves": 6054, "interactions": 216333, "interact_rate": 0.0432, "finish_rate": 0.0882 }, "extra": { "source_id": "7674181083131054406", "published_at": "2026-08-15T17:02:03+08:00", "duration_s": 249.915, "labels": [ "陈翔短剧", "搞笑剧情", "青春期烦恼" ], "music": { "id": "7674181093137992502", "title": "@犟种兄弟创作的原声" }, "url": "https://www.douyin.com/video/7674181083131054406" }, "prov": { "hash": "0x6fb2ea24c0fd500c", "ts": "2026-10-20T12:00:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.010000", "balance_usd": "9.990000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.xingtu.video_report", "x-qovia-title-zh": "抖音星图视频数据", "x-qovia-description-zh": "单个抖音视频在星图里的数据：播放、点赞、评论、分享、收藏、互动数、互动率、完播率、内容标签、背景音乐， 以及作者的星图 ID、抖音 uid、昵称和粉丝数。星图里没有这个视频时返回 404，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:xingtu", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 10000, "usd_per_call": "0.010000", "usd_per_1k": "10" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.xingtu.video_report/" } }, "/v1/raw/xingtu/video_trend": { "get": { "operationId": "raw_xingtu_video_trend", "summary": "Douyin Xingtu video daily trend", "description": "Daily series for about 30 days after a video was posted: plays, valid plays, likes, comments, shares, saves, interactions, interaction rate, completion rate and heat, in date order. Rates are Xingtu's basis-point integers (548 = 5.48%). Videos without a trend answer empty and are not charged.", "tags": [ "Douyin Xingtu" ], "parameters": [ { "name": "item_id", "in": "query", "required": true, "description": "Douyin video ID (aweme_id)", "x-qovia-description-zh": "抖音作品 ID（aweme_id）", "schema": { "type": "string", "pattern": "^[0-9]{15,20}$", "examples": [ "7674181083131054406" ] }, "example": "7674181083131054406" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "id": "soc_xin_8281ea03739f", "src": "social", "platform": "xingtu", "item_id": "7674181083131054406", "series": { "plays": [ { "date": "2026-08-15", "value": 939414 }, { "date": "2026-08-16", "value": 745262 } ], "valid_plays": [ { "date": "2026-08-15", "value": 872988 }, { "date": "2026-08-16", "value": 681942 } ], "likes": [ { "date": "2026-08-15", "value": 47684 }, { "date": "2026-08-16", "value": 35140 } ], "comments": [ { "date": "2026-08-15", "value": 318 }, { "date": "2026-08-16", "value": 174 } ], "shares": [ { "date": "2026-08-15", "value": 3566 }, { "date": "2026-08-16", "value": 2446 } ], "saves": [ { "date": "2026-08-15", "value": 1696 }, { "date": "2026-08-16", "value": 1026 } ], "interactions": [ { "date": "2026-08-15", "value": 51568 }, { "date": "2026-08-16", "value": 37760 } ], "interact_rate": [ { "date": "2026-08-15", "value": 548 }, { "date": "2026-08-16", "value": 506 } ], "finish_rate": [ { "date": "2026-08-15", "value": 876 }, { "date": "2026-08-16", "value": 1060 } ], "hot_score": [ { "date": "2026-08-15", "value": 1742806 }, { "date": "2026-08-16", "value": 1362534 } ] }, "prov": { "hash": "0x52c9e0b7a1f3d684", "ts": "2026-10-20T12:00:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.010000", "balance_usd": "9.990000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.xingtu.video_trend", "x-qovia-title-zh": "抖音星图视频每日趋势", "x-qovia-description-zh": "单个视频发布后约 30 天的每日数据：播放、有效播放、点赞、评论、分享、收藏、互动、互动率、完播率、热度， 按日期升序。互动率和完播率是星图的万分比整数（548 表示 5.48%）。没有趋势数据时返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:xingtu", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 10000, "usd_per_call": "0.010000", "usd_per_1k": "10" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.xingtu.video_trend/" } }, "/v1/raw/xingtu/video_transcript": { "get": { "operationId": "raw_xingtu_video_transcript", "summary": "Douyin Xingtu video transcript", "description": "Subtitles or speech transcript of a video, as timed segments (milliseconds) plus the joined full text. Slow (about 8 s). Videos without speech or subtitles answer empty and are not charged.", "tags": [ "Douyin Xingtu" ], "parameters": [ { "name": "item_id", "in": "query", "required": true, "description": "Douyin video ID (aweme_id)", "x-qovia-description-zh": "抖音作品 ID（aweme_id）", "schema": { "type": "string", "pattern": "^[0-9]{15,20}$", "examples": [ "7674181083131054406" ] }, "example": "7674181083131054406" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "id": "soc_xin_7e16cf83eb7d", "src": "social", "platform": "xingtu", "item_id": "7674181083131054406", "lang": "zh-CN", "text": "你家孩子假期上烧烤店打工去了，他说他想体验体验。\n不是，你看你这家长，眼瞅开学高三了…", "segments": [ { "start_ms": 0, "end_ms": 3000, "text": "你家孩子假期上烧烤店打工去了，他说他想体验体验。" }, { "start_ms": 3000, "end_ms": 9000, "text": "不是，你看你这家长，眼瞅开学高三了…" } ], "prov": { "hash": "0x77854123a4ee6355", "ts": "2026-10-20T12:00:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.010000", "balance_usd": "9.990000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.xingtu.video_transcript", "x-qovia-title-zh": "抖音星图视频字幕文本", "x-qovia-description-zh": "视频的字幕或语音转写文本，按时间分段（毫秒）并给出拼接好的全文。较慢（约 8 秒）。没有字幕的视频返回空结果， 不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:xingtu", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 10000, "usd_per_call": "0.010000", "usd_per_1k": "10" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.xingtu.video_transcript/" } }, "/v1/raw/xingtu/videos": { "get": { "operationId": "raw_xingtu_videos", "summary": "Douyin Xingtu videos in bulk", "description": "Title, posting time, duration, plays, likes, comments, shares, saves and interaction rate for up to 20 Douyin videos per call. Order may differ from the request and unknown ids are simply missing; charged per call, and a call where none is found answers empty and is not charged.", "tags": [ "Douyin Xingtu" ], "parameters": [ { "name": "item_ids", "in": "query", "required": true, "description": "Douyin video IDs, comma-separated, up to 20", "x-qovia-description-zh": "抖音作品 ID，英文逗号分隔，最多 20 个", "schema": { "type": "string", "pattern": "^[0-9]{15,20}(,[0-9]{15,20}){0,19}$", "examples": [ "7674181083131054406,7694234405623846756" ] }, "example": "7674181083131054406,7694234405623846756" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "id": "soc_xin_395a33e12d11", "src": "social", "platform": "xingtu", "lang": "zh-CN", "text": "老许：都是为了孩子…", "author": { "author_id": null, "douyin_uid": "2422960710762380", "name": null, "followers": null }, "metrics": { "plays": 1233342, "likes": 50594, "comments": 177, "shares": 2577, "saves": 2003, "interact_rate": 0.0432 }, "extra": { "source_id": "7694234405623846756", "published_at": "2026-10-08T18:49:28+08:00", "duration_s": 298.143, "url": "https://www.douyin.com/video/7694234405623846756" }, "prov": { "hash": "0xa7819a80f0ef02e5", "ts": "2026-10-20T12:00:00+08:00", "source": "live" } } ], "cursor": null, "has_more": false }, "meta": { "billed": true, "charged_usd": "0.010000", "balance_usd": "9.990000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.xingtu.videos", "x-qovia-title-zh": "抖音星图视频批量指标", "x-qovia-description-zh": "一次查询最多 20 个抖音视频的标题、发布时间、时长、播放、点赞、评论、分享、收藏和互动率。返回顺序不保证与 请求一致，查不到的 ID 直接缺席；按次计费，全部查不到时返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:xingtu", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 10000, "usd_per_call": "0.010000", "usd_per_1k": "10" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.xingtu.videos/" } }, "/v1/raw/xingtu/author_seeding_v2": { "get": { "operationId": "raw_xingtu_author_seeding_v2", "summary": "Douyin Xingtu creator search lift V2", "description": "Xingtu's search lift for a creator, returned as Xingtu answers: the average searches after viewing personal_avg_search_after_view_cnt with its peer percentile personal_avg_search_after_view_cnt_rank_percent, the search-after-view rate personal_avg_search_after_view_rate and the search-term CTR personal_search_word_ctr, plus modify_time and base_resp. Xingtu only publishes display values (such as \"100 - 1,000\" or \"<0.02%\"), returned as strings; the window is Xingtu's default and cannot be chosen. Fast: usually about 2 seconds. A creator without data (those fields missing, or only base_resp) answers empty. Only an answer with data is charged; an empty answer or an error is not.", "tags": [ "Douyin Xingtu" ], "parameters": [ { "name": "author_id", "in": "query", "required": true, "description": "Xingtu creator ID (o_author_id)", "x-qovia-description-zh": "星图作者 ID（o_author_id）", "schema": { "type": "string", "pattern": "^[0-9]{15,20}$", "examples": [ "6790158034132795406" ] }, "example": "6790158034132795406" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "base_resp": { "status_code": 0, "status_message": "" }, "modify_time": "1793335293", "personal_avg_search_after_view_cnt": "100 - 1,000", "personal_avg_search_after_view_cnt_rank_percent": "0.9", "personal_avg_search_after_view_rate": "<0.02%", "personal_search_word_ctr": "1% - 1.5%" }, "meta": { "billed": true, "charged_usd": "0.025360", "balance_usd": "9.974640", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.xingtu.author_seeding_v2", "x-qovia-title-zh": "抖音星图达人种草价值 V2", "x-qovia-description-zh": "星图给出的达人种草价值（原样 JSON）：看过达人视频后的平均搜索次数 personal_avg_search_after_view_cnt 及同类排名百分位 personal_avg_search_after_view_cnt_rank_percent、看后搜索率 personal_avg_search_after_view_rate、搜索词点击率 personal_search_word_ctr，以及 modify_time、base_resp。 星图只给展示值（如\"100 - 1,000\"、\"<0.02%\"），按字符串原样输出；统计窗口为星图的默认窗口，不可选。响应较快，通常约 2 秒。 没有数据（缺少这些字段或只有 base_resp）时返回空结果。只对有数据的结果计费，空结果和出错都不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:xingtu", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 25360, "usd_per_call": "0.025360", "usd_per_1k": "25.36" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.xingtu.author_seeding_v2/" } }, "/v1/raw/xingtu/author_videos_v3": { "get": { "operationId": "raw_xingtu_author_videos_v3", "summary": "Douyin Xingtu creator homepage videos V3", "description": "The video list on a Xingtu creator's homepage, returned as Xingtu answers: each entry in items holds item_id, video_id, title, create_time, duration, plays watch_cnt, likes like_cnt, comments comment_cnt, interact_rate, finish_rate, content_theme_labels, cover and link, plus pagination (page, limit, total_count, has_more) and base_resp. Optional page (default 1; continue while has_more is true). Fast: usually about 3 seconds. A creator without videos (items missing or empty, or only base_resp) answers empty. Only an answer with data is charged; an empty answer or an error is not.", "tags": [ "Douyin Xingtu" ], "parameters": [ { "name": "author_id", "in": "query", "required": true, "description": "Xingtu creator ID (o_author_id)", "x-qovia-description-zh": "星图作者 ID（o_author_id）", "schema": { "type": "string", "pattern": "^[0-9]{15,20}$", "examples": [ "6790158034132795406" ] }, "example": "6790158034132795406" }, { "name": "page", "in": "query", "required": false, "description": "Page number, 1 for the first page", "x-qovia-description-zh": "页码，第一页为 1", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 1 } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "base_resp": { "status_code": 0, "status_message": "" }, "items": [ { "comment_cnt": "106", "content_theme_labels": [ "恋爱演绎", "剧情反转", "有趣剧情创作" ], "create_time": "1792663299", "duration": 198.088, "finish_rate": 0.149649, "interact_rate": 0.023986, "item_id": "7699430238710864758", "like_cnt": "20010", "title": "涛声依旧了…", "video_id": "v0d00fg10000dbctsa7og65it4iqncfg", "watch_cnt": "886249" } ], "pagination": { "has_more": false, "limit": 20, "page": 1, "total_count": 19 } }, "meta": { "billed": true, "charged_usd": "0.084510", "balance_usd": "9.915490", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.xingtu.author_videos_v3", "x-qovia-title-zh": "抖音星图达人主页视频 V3", "x-qovia-description-zh": "星图达人主页的视频列表（原样 JSON）：items 中每条含 item_id、video_id、title、create_time、duration、播放数 watch_cnt、点赞数 like_cnt、评论数 comment_cnt、互动率 interact_rate、完播率 finish_rate、内容主题标签 content_theme_labels、封面和链接，另有 pagination（page、limit、total_count、has_more）和 base_resp。 可选 page（默认 1，has_more 为 true 时继续翻页）。响应较快，通常约 3 秒。 没有视频（items 缺失或为空，或只有 base_resp）时返回空结果。只对有数据的结果计费，空结果和出错都不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:xingtu", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 84510, "usd_per_call": "0.084510", "usd_per_1k": "84.51" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.xingtu.author_videos_v3/" } }, "/v1/raw/tieba/thread": { "get": { "operationId": "raw_tieba_thread", "summary": "Tieba thread", "description": "Opening post of a thread (text, author, likes/saves/shares/replies, forum) plus one page of floors, about 15 per page in floor order, each with its author's nickname, level and IP location. Use raw.tieba.replies for replies inside a floor. Deleted or unknown threads answer 404 and a page past the end answers empty; neither is charged.", "tags": [ "Tieba" ], "parameters": [ { "name": "thread_id", "in": "query", "required": true, "description": "Thread ID (the number after tieba.baidu.com/p/)", "x-qovia-description-zh": "帖子 ID（tieba.baidu.com/p/ 后面的数字）", "schema": { "type": "string", "pattern": "^[1-9][0-9]{0,19}$", "examples": [ "10693684727" ] }, "example": "10693684727" }, { "name": "page", "in": "query", "required": false, "description": "Reply page, from 1; only page 1 carries the opening post's full text and images", "x-qovia-description-zh": "回复页码，从 1 开始；只有第 1 页带主楼全文和图片", "schema": { "type": "integer", "minimum": 1, "maximum": 10000, "default": 1 } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "id": "soc_tie_3f9a1c27b04e", "src": "social", "platform": "tieba", "lang": "zh-CN", "text": "觉醒套和混搭传说五到底先做哪个？[小乖]黄金乡才传说二，有没有必要现在换。", "author": { "uid_hash": "8d41e0a7c2f5", "user_id": "1234567890", "portrait": "tb.1.5a3c9e10.Qx7nB2kLmP4rT8vW1yZ0aA", "nickname": "阿拉德老玩家", "ip_location": "湖北", "level": 9, "followers": null }, "metrics": { "replies": 31, "likes": 7, "saves": 1, "shares": 0 }, "extra": { "source_id": "10000000001", "title": "问个套装问题", "url": "https://tieba.baidu.com/p/10000000001", "forum": { "id": "81570", "name": "地下城与勇士", "category": "游戏", "subcategory": "网络游戏" }, "published_at": "2026-05-06T09:45:46+08:00", "images": [ "https://tiebapic.baidu.com/forum/pic/item/0000example.jpg" ], "posts": [ { "pid": "150000000002", "floor": 2, "text": "等新团本出来再考虑，混搭传说五够打现阶段的本了", "images": [], "created_at": "2026-05-06T09:47:39+08:00", "likes": 0, "reply_count": 3, "author": { "uid_hash": "2b7f90c13e6d", "user_id": "2234567890", "portrait": "tb.1.9e2d4b61.Hn3sK8pQ2wX5vC7mZ1rT4g", "nickname": "雷阵雨", "ip_location": "浙江", "level": 10 } } ], "page": { "current": 1, "total": 2, "has_more": true } }, "prov": { "hash": "0x0f1e2d3c4b5a6978", "ts": "2026-10-20T12:00:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001500", "balance_usd": "9.998500", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.tieba.thread", "x-qovia-title-zh": "贴吧帖子", "x-qovia-description-zh": "帖子主楼（正文、作者、点赞收藏分享和回复数、所在吧）以及指定页的楼层回复，每页约 15 层，按楼层正序。 楼层作者的昵称、等级和 IP 属地已关联好；楼中楼回复用 raw.tieba.replies 获取。帖子已删除或不存在时返回 404，页码超过总页数时返回空结果，均不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:tieba", "x-qovia-price": { "mode": "tiered", "unit_price_micros": 1500, "usd_per_call": "0.001500", "usd_per_1k": "1.5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.tieba.thread/" } }, "/v1/raw/tieba/replies": { "get": { "operationId": "raw_tieba_replies", "summary": "Tieba floor replies", "description": "Replies inside one floor of a thread, 10 per page, cursor-paginated (a null cursor means no more). Each reply has its author's nickname and IP location; a \"回复 someone :\" prefix is split into reply_to. Take post_id from raw.tieba.thread extra.posts[].pid. A floor without replies, or an unknown post_id, answers empty and is not charged.", "tags": [ "Tieba" ], "parameters": [ { "name": "thread_id", "in": "query", "required": true, "description": "Thread ID", "x-qovia-description-zh": "帖子 ID", "schema": { "type": "string", "pattern": "^[1-9][0-9]{0,19}$", "examples": [ "10693684727" ] }, "example": "10693684727" }, { "name": "post_id", "in": "query", "required": true, "description": "Floor ID (the pid of a reply in the thread)", "x-qovia-description-zh": "楼层 ID（帖子回复里的 pid）", "schema": { "type": "string", "pattern": "^[1-9][0-9]{0,19}$", "examples": [ "153488634022" ] }, "example": "153488634022" }, { "name": "cursor", "in": "query", "required": false, "description": "The cursor returned by the previous page", "x-qovia-description-zh": "上一页返回的 cursor", "schema": { "type": "integer", "minimum": 0, "maximum": 100000, "default": 0 } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "pid": "150000000101", "text": "不应该是先有誓约吗", "images": [], "created_at": "2026-05-06T11:15:11+08:00", "likes": 0, "reply_to": null, "author": { "uid_hash": "6c0d2a9e81f4", "user_id": "3234567890", "portrait": "tb.1.c41f7a02.Lp8xQ2mN5vB3kR9tW6yZ1h", "nickname": "夏末", "ip_location": "广东", "level": null } }, { "pid": "150000000102", "text": "太初誓约哪有这么好出", "images": [], "created_at": "2026-05-06T12:20:05+08:00", "likes": 2, "reply_to": { "user_id": "3234567890", "nickname": "夏末", "portrait": "tb.1.c41f7a02.Lp8xQ2mN5vB3kR9tW6yZ1h" }, "author": { "uid_hash": "0e5b7d31a9c2", "user_id": "4234567890", "portrait": "tb.1.7b20e5d9.Vt4cH8sJ1nK6pQ3wE9rU2f", "nickname": "星系", "ip_location": "广东", "level": null } } ], "cursor": 10, "has_more": true }, "meta": { "billed": true, "charged_usd": "0.001500", "balance_usd": "9.998500", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.tieba.replies", "x-qovia-title-zh": "贴吧楼中楼回复", "x-qovia-description-zh": "某一层楼下面的楼中楼回复，每页 10 条，用 cursor 翻页（cursor 为 null 表示没有更多）。每条带作者昵称和 IP 属地；\"回复 某人 :\" 的前缀会拆到 reply_to 里。post_id 取自 raw.tieba.thread 的 extra.posts[].pid。 这层没有回复（或 post_id 不存在）时返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:tieba", "x-qovia-price": { "mode": "tiered", "unit_price_micros": 1500, "usd_per_call": "0.001500", "usd_per_1k": "1.5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.tieba.replies/" } }, "/v1/raw/tieba/user": { "get": { "operationId": "raw_tieba_user", "summary": "Tieba user profile", "description": "Public profile of a Tieba user: nickname, followers, following, likes received, account age, IP location and gender. Pass the author.portrait returned by raw.tieba.thread or raw.tieba.replies (a ?t= suffix is accepted). Unknown users answer 404 and are not charged.", "tags": [ "Tieba" ], "parameters": [ { "name": "portrait", "in": "query", "required": true, "description": "User portrait, shaped like tb.1.xxxxxxxx.xxxx", "x-qovia-description-zh": "用户 portrait，形如 tb.1.xxxxxxxx.xxxx", "schema": { "type": "string", "pattern": "^tb\\.1\\.[0-9a-f]{1,8}\\.[A-Za-z0-9_-]{1,64}(\\?t=[0-9]{1,13})?$", "examples": [ "tb.1.704b7e76.oTmPuocly9yrPuREuR_FUg" ] }, "example": "tb.1.704b7e76.oTmPuocly9yrPuREuR_FUg" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "uid_hash": "8d41e0a7c2f5", "user_id": "1234567890", "portrait": "tb.1.5a3c9e10.Qx7nB2kLmP4rT8vW1yZ0aA", "nickname": "阿拉德老玩家", "username": "alade_player", "followers": 5, "following": 3, "total_likes": 138, "account_age_years": 13.1, "ip_location": "湖北", "gender": "male", "deregistered": false, "extra": { "tieba_uid": "300000001" }, "prov": { "hash": "0x9a8b7c6d5e4f3021", "ts": "2026-10-20T12:00:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001500", "balance_usd": "9.998500", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.tieba.user", "x-qovia-title-zh": "贴吧用户资料", "x-qovia-description-zh": "用户公开资料：昵称、粉丝和关注数、获赞数、吧龄、IP 属地、性别。portrait 取自 raw.tieba.thread 或 raw.tieba.replies 返回的 author.portrait，可带 ?t= 后缀。用户不存在时返回 404，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:tieba", "x-qovia-price": { "mode": "tiered", "unit_price_micros": 1500, "usd_per_call": "0.001500", "usd_per_1k": "1.5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.tieba.user/" } }, "/v1/raw/zhihu/question": { "get": { "operationId": "raw_zhihu_question", "summary": "Zhihu question detail", "description": "One Zhihu question: title and description (plain text, its images listed apart), answer, follower, view and comment counts, asked and last-edited times (Beijing time). This route does not name the asker. A question that does not exist answers 404 and is not charged.", "tags": [ "Zhihu" ], "parameters": [ { "name": "question_id", "in": "query", "required": true, "description": "Question ID (the number in zhihu.com/question/)", "x-qovia-description-zh": "问题 ID（问题链接 zhihu.com/question/ 里的数字）", "schema": { "type": "string", "pattern": "^[0-9]{1,20}$", "examples": [ "2096149013556721446" ] }, "example": "2096149013556721446" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "id": "soc_zhi_66b674e3553a", "src": "social", "platform": "zhihu", "lang": "zh-CN", "text": "医保个人账户跨省共济落地全国，意味着什么？将带来哪些利好？\n近日，国家医保局上线医保钱包2.0版。自10月16日起，全国各省、自治区、直辖市及新疆生产建设兵团已全部上线运行，职工医保个人账户跨省共济在全国全面落地。\n职工医保个人账户跨省共济，依托全国统一医保信息平台设立个人医保钱…", "author": null, "metrics": { "answers": 215, "followers": 1189, "views": 795008, "comments": 18 }, "extra": { "source_id": "2096149013556721446", "content_type": "question", "title": "医保个人账户跨省共济落地全国，意味着什么？将带来哪些利好？", "published_at": "2026-10-21T08:01:09+08:00", "updated_at": "2026-10-21T08:01:09+08:00", "question_type": "normal", "images": [ "https://pic3.zhimg.com/v2-45bde134b33053a220851030596f9a10_r.jpg" ], "url": "https://www.zhihu.com/question/2096149013556721446" }, "prov": { "hash": "0xc4475716f5e931bd", "ts": "2026-10-21T23:45:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.zhihu.question", "x-qovia-title-zh": "知乎问题详情", "x-qovia-description-zh": "单个知乎问题：标题与问题描述（纯文本，图片单独列出）、回答数、关注数、浏览量、评论数、提问与最后编辑时间（北京时间）。 知乎此接口不返回提问者。问题不存在时返回 404，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:zhihu", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.zhihu.question/" } }, "/v1/raw/zhihu/answers": { "get": { "operationId": "raw_zhihu_answers", "summary": "Zhihu question answers", "description": "Answers to one question, up to 20: text (plain text, its images listed apart), author (with followers), upvotes, comments, saves, published and edited times, as the same records as answer detail (same ids). Zhihu's default order or newest first. First page only: Zhihu's next page cannot be reached through the current source. A question without answers answers empty, one that does not exist 404 or empty; neither is charged.", "tags": [ "Zhihu" ], "parameters": [ { "name": "question_id", "in": "query", "required": true, "description": "Question ID (the number in zhihu.com/question/)", "x-qovia-description-zh": "问题 ID（问题链接 zhihu.com/question/ 里的数字）", "schema": { "type": "string", "pattern": "^[0-9]{1,20}$", "examples": [ "2096149013556721446" ] }, "example": "2096149013556721446" }, { "name": "sort", "in": "query", "required": false, "description": "Order: default (Zhihu's ranking, the default) or latest (newest first)", "x-qovia-description-zh": "排序：default 知乎默认排序（默认）、latest 最新", "schema": { "type": "string", "enum": [ "default", "latest" ], "default": "default" } }, { "name": "count", "in": "query", "required": false, "description": "How many answers", "x-qovia-description-zh": "条数", "schema": { "type": "integer", "minimum": 1, "maximum": 20, "default": 20 } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "id": "soc_zhi_0adb8742dcb5", "src": "social", "platform": "zhihu", "lang": "zh-CN", "text": "必须点个赞，对老百姓确实是个好事来的。\n简单来说，这套制度其实有点类似支付宝的亲情卡，就是你可以把某个人绑定你的亲情卡，然后设定一个限额，被绑定的这个人用支付宝支付的时候就可以直接用亲情卡支付，说白了就是可以在这个限额内花你的钱。\n只不过支付宝亲情卡的绑定门槛比较低，只要你愿意，…", "author": { "uid_hash": "86af6819638a", "followers": 16239, "nickname": "法途萤光", "user_id": "67ea9758246085568d7b80fd4dc7e1cd", "url_token": "lao-bei-jing-feng-jing" }, "metrics": { "likes": 575, "comments": 118, "saves": 376 }, "extra": { "source_id": "2096190323630387908", "content_type": "answer", "title": "医保个人账户跨省共济落地全国，意味着什么？将带来哪些利好？", "question_id": "2096149013556721446", "published_at": "2026-10-21T10:45:18+08:00", "updated_at": "2026-10-21T10:45:18+08:00", "images": [ "https://pic1.zhimg.com/v2-e642605f52f9daec39c479ea4b30c974_r.jpg?source=1def8aca" ], "cover_url": "https://pica.zhimg.com/80/v2-321f1f4709aab5b1d37b1f459cfdd7a8_720w.jpg?source=1def8aca", "url": "https://www.zhihu.com/question/2096149013556721446/answer/2096190323630387908" }, "prov": { "hash": "0xb583077894ac21f0", "ts": "2026-10-21T23:45:00+08:00", "source": "live" } }, { "id": "soc_zhi_5ef66c782c7d", "src": "social", "platform": "zhihu", "lang": "zh-CN", "text": "这是在医保跨省就医先备案再结算的基础上又一项便利的举措。\n推出医保个人账户跨省共济，对于那些个人账户躺着大笔资金，又在异地有亲人要就医治疗的人来说，终于可以使用个人账户的资金来帮助亲人看病了。意味着你职工医保个人账户里的钱，可以跨省给在老家的近亲属用了。\n知乎有一个比较热的讨论话…", "author": { "uid_hash": "edd664f97ba1", "followers": 104, "nickname": "任***生", "user_id": "00000000000000000000000000000001", "url_token": "example-user-1" }, "metrics": { "likes": 64, "comments": 24, "saves": 22 }, "extra": { "source_id": "2096156906813387925", "content_type": "answer", "title": "医保个人账户跨省共济落地全国，意味着什么？将带来哪些利好？", "question_id": "2096149013556721446", "published_at": "2026-10-21T08:32:31+08:00", "updated_at": "2026-10-21T08:32:31+08:00", "images": [], "cover_url": null, "url": "https://www.zhihu.com/question/2096149013556721446/answer/2096156906813387925" }, "prov": { "hash": "0x7ee96186b1cd145c", "ts": "2026-10-21T23:45:00+08:00", "source": "live" } } ], "prov": { "hash": "0x606c3670bc320b62", "ts": "2026-10-21T23:45:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.zhihu.answers", "x-qovia-title-zh": "知乎问题回答列表", "x-qovia-description-zh": "一个问题下的回答，最多 20 条：正文（纯文本，图片单独列出）、作者（含粉丝数）、赞同数、评论数、收藏数、发布与编辑时间，记录与回答详情相同（同一 id）。 可按知乎默认排序或最新排序。仅提供第一页：知乎的下一页无法通过当前数据源获取。没有回答时返回空结果，问题不存在时返回 404 或空结果，均不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:zhihu", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.zhihu.answers/" } }, "/v1/raw/zhihu/answer": { "get": { "operationId": "raw_zhihu_answer", "summary": "Zhihu answer detail", "description": "One answer: text (plain text, its images listed apart), author, its question (title and ID), published and edited times, as the same record as the answer list (same id). This route carries no upvote, comment or save counts (null): raw.zhihu.answers and raw.zhihu.article_search do. An answer that does not exist answers 404 and is not charged.", "tags": [ "Zhihu" ], "parameters": [ { "name": "answer_id", "in": "query", "required": true, "description": "Answer ID (the number in zhihu.com/question//answer/)", "x-qovia-description-zh": "回答 ID（回答链接 zhihu.com/question/<问题 ID>/answer/ 里的数字）", "schema": { "type": "string", "pattern": "^[0-9]{1,20}$", "examples": [ "2096190323630387908" ] }, "example": "2096190323630387908" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "id": "soc_zhi_0adb8742dcb5", "src": "social", "platform": "zhihu", "lang": "zh-CN", "text": "必须点个赞，对老百姓确实是个好事来的。\n简单来说，这套制度其实有点类似支付宝的亲情卡，就是你可以把某个人绑定你的亲情卡，然后设定一个限额，被绑定的这个人用支付宝支付的时候就可以直接用亲情卡支付，说白了就是可以在这个限额内花你的钱。\n只不过支付宝亲情卡的绑定门槛比较低，只要你愿意，…", "author": { "uid_hash": "86af6819638a", "followers": null, "nickname": "法途萤光", "user_id": "67ea9758246085568d7b80fd4dc7e1cd", "url_token": "lao-bei-jing-feng-jing" }, "metrics": { "likes": null, "comments": null, "saves": null }, "extra": { "source_id": "2096190323630387908", "content_type": "answer", "title": "医保个人账户跨省共济落地全国，意味着什么？将带来哪些利好？", "question_id": "2096149013556721446", "published_at": "2026-10-21T10:45:18+08:00", "updated_at": "2026-10-21T10:45:18+08:00", "images": [ "https://picx.zhimg.com/v2-e642605f52f9daec39c479ea4b30c974_r.jpg?source=2c26e567" ], "cover_url": "https://picx.zhimg.com/v2-e642605f52f9daec39c479ea4b30c974_r.jpg?source=2c26e567", "url": "https://www.zhihu.com/question/2096149013556721446/answer/2096190323630387908" }, "prov": { "hash": "0xb894b5103868a2cb", "ts": "2026-10-21T23:45:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.zhihu.answer", "x-qovia-title-zh": "知乎回答详情", "x-qovia-description-zh": "单个回答：正文（纯文本，图片单独列出）、作者、所属问题（标题与 ID）、发布与编辑时间，记录与回答列表相同（同一 id）。 知乎此接口不返回赞同、评论和收藏数（为 null），需要时用 raw.zhihu.answers 或 raw.zhihu.article_search。回答不存在时返回 404，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:zhihu", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.zhihu.answer/" } }, "/v1/raw/zhihu/comments": { "get": { "operationId": "raw_zhihu_comments", "summary": "Zhihu answer comments", "description": "First-level comments of an answer, cursor-paginated, 10 a page: text, likes, reply count, IP location, time (Beijing time), whether it is a hot comment, and the commenter. Hottest first (the default) or newest first. Pass the previous page's cursor back to continue; stop when has_more is false. Replies come from raw.zhihu.comment_replies. An answer without comments, or one that does not exist, answers empty and is not charged.", "tags": [ "Zhihu" ], "parameters": [ { "name": "answer_id", "in": "query", "required": true, "description": "Answer ID", "x-qovia-description-zh": "回答 ID", "schema": { "type": "string", "pattern": "^[0-9]{1,20}$", "examples": [ "2096190323630387908" ] }, "example": "2096190323630387908" }, { "name": "sort", "in": "query", "required": false, "description": "Order: hot (the default) or latest (newest first)", "x-qovia-description-zh": "排序：hot 热度（默认）、latest 最新", "schema": { "type": "string", "enum": [ "hot", "latest" ], "default": "hot" } }, { "name": "cursor", "in": "query", "required": false, "description": "The cursor from the previous page's response; leave it out for the first page", "x-qovia-description-zh": "取上一页响应的 cursor；第一页不传", "schema": { "type": "string", "pattern": "^[0-9]{1,20}_[0-9]{1,20}_[0-9]{1,2}$" } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "cid": "11601712556", "text": "本来就是个人账户的钱，没啥值得老百姓鼓掌的", "likes": 109, "ip_location": "北京", "reply_count": 15, "created_at": "2026-10-21T13:08:56+08:00", "is_hot": false, "images": [], "author": { "uid_hash": "94b392d47736", "nickname": "L***e", "user_id": "00000000000000000000000000000002", "url_token": "example-user-2" } }, { "cid": "11601773273", "text": "其实没啥用，因为国家没出钱。个人账户的钱跟你个人银行卡的钱其实差不多，迟早都是用的。而且，大部分人，个人账户也没多少钱，有的都是体制内的。", "likes": 52, "ip_location": "重庆", "reply_count": 5, "created_at": "2026-10-21T14:21:30+08:00", "is_hot": false, "images": [], "author": { "uid_hash": "02bcf44137fc", "nickname": "山***生", "user_id": "00000000000000000000000000000003", "url_token": "example-user-3" } } ], "cursor": "648091405_11601921724_0", "has_more": true, "total": 118, "prov": { "hash": "0xfe8c592741eb8410", "ts": "2026-10-21T23:45:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.zhihu.comments", "x-qovia-title-zh": "知乎回答评论", "x-qovia-description-zh": "回答的一级评论，按游标翻页，每页 10 条：评论内容、点赞数、回复数、IP 属地、时间（北京时间）、是否热评和评论者。可按热度（默认）或最新排序。 把上一页返回的 cursor 传回即可翻页，has_more 为 false 时停止。回复用 raw.zhihu.comment_replies 获取。没有评论或回答不存在时返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:zhihu", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.zhihu.comments/" } }, "/v1/raw/zhihu/comment_replies": { "get": { "operationId": "raw_zhihu_comment_replies", "summary": "Zhihu comment replies", "description": "Replies under one first-level comment, cursor-paginated, up to 20 a page: text, likes, IP location, time (Beijing time), the reply it answers, and the replier. Hottest first (the default) or oldest first. Pass the previous page's cursor back to continue; stop when has_more is false. A comment without replies answers empty and is not charged.", "tags": [ "Zhihu" ], "parameters": [ { "name": "comment_id", "in": "query", "required": true, "description": "First-level comment cid (from the answer comments endpoint)", "x-qovia-description-zh": "一级评论 cid（来自回答评论接口）", "schema": { "type": "string", "pattern": "^[0-9]{1,20}$", "examples": [ "11601712556" ] }, "example": "11601712556" }, { "name": "sort", "in": "query", "required": false, "description": "Order: hot (the default) or oldest (oldest first)", "x-qovia-description-zh": "排序：hot 热度（默认）、oldest 时间（最早在前）", "schema": { "type": "string", "enum": [ "hot", "oldest" ], "default": "hot" } }, { "name": "count", "in": "query", "required": false, "description": "Items per page", "x-qovia-description-zh": "每页条数", "schema": { "type": "integer", "minimum": 1, "maximum": 20, "default": 20 } }, { "name": "cursor", "in": "query", "required": false, "description": "The cursor from the previous page's response; leave it out for the first page", "x-qovia-description-zh": "取上一页响应的 cursor；第一页不传", "schema": { "type": "string", "pattern": "^[0-9]{1,20}_[0-9]{1,20}_[0-9]{1,2}$" } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "cid": "11601513968", "text": "改变就是好事", "likes": 46, "ip_location": "广东", "reply_count": null, "created_at": "2026-10-21T14:57:14+08:00", "is_hot": false, "images": [], "author": { "uid_hash": "8a8ca2db203a", "nickname": "一***佬", "user_id": "00000000000000000000000000000004", "url_token": "example-user-4" }, "parent_cid": "11601712556", "reply_to_cid": null }, { "cid": "11601688358", "text": "做得好可以稍微夸一下，这是正负应该做的，做得不好就该直接骂", "likes": 8, "ip_location": "广东", "reply_count": null, "created_at": "2026-10-21T16:27:12+08:00", "is_hot": false, "images": [], "author": { "uid_hash": "c5330daf21ae", "nickname": "A***号", "user_id": "00000000000000000000000000000005", "url_token": "example-user-5" }, "parent_cid": "11601712556", "reply_to_cid": "11601513968" } ], "cursor": "1792574724_11602011360_0", "has_more": true, "total": 15, "prov": { "hash": "0x0595094c4644d6f1", "ts": "2026-10-21T23:45:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.zhihu.comment_replies", "x-qovia-title-zh": "知乎评论回复", "x-qovia-description-zh": "某条一级评论下的回复（楼中楼），按游标翻页，每页最多 20 条：内容、点赞数、IP 属地、时间（北京时间）、回复对象和回复者。可按热度（默认）或时间（最早在前）排序。 把上一页返回的 cursor 传回即可翻页，has_more 为 false 时停止。没有回复时返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:zhihu", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.zhihu.comment_replies/" } }, "/v1/raw/zhihu/user": { "get": { "operationId": "raw_zhihu_user", "summary": "Zhihu user profile", "description": "A Zhihu user's profile: nickname, followers, answer and article counts, verification, whether it is an organisation, IP location, employers listed on the profile, headline and avatar. Pass the url_token (from zhihu.com/people/). This route carries no following or upvote totals. A user that does not exist answers 404 and is not charged.", "tags": [ "Zhihu" ], "parameters": [ { "name": "url_token", "in": "query", "required": true, "description": "The user's url_token (from zhihu.com/people/)", "x-qovia-description-zh": "用户 url_token（主页链接 zhihu.com/people/ 里的部分）", "schema": { "type": "string", "pattern": "^[A-Za-z0-9_.-]{1,100}$", "examples": [ "lao-bei-jing-feng-jing" ] }, "example": "lao-bei-jing-feng-jing" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "uid_hash": "86af6819638a", "platform": "zhihu", "user_id": "67ea9758246085568d7b80fd4dc7e1cd", "url_token": "lao-bei-jing-feng-jing", "nickname": "法途萤光", "followers": 16239, "answers": 2068, "articles": 26, "verified": true, "verify_reason": "法律职业资格证持证人", "is_org": false, "ip_location": "广东", "employers": [ "律师事务所", "金融企业" ], "signature": "吃货法师\n法律行业多年工作经验 亏啥也不能亏了胃", "avatar_url": "https://pic1.zhimg.com/v2-fdb0486b8ed0dd00d64eec59f834e3a0_xl.jpg?source=32738c0c&needBackground=1", "url": "https://www.zhihu.com/people/lao-bei-jing-feng-jing", "prov": { "hash": "0xbfe9dbbcafef308b", "ts": "2026-10-21T23:45:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.zhihu.user", "x-qovia-title-zh": "知乎用户资料", "x-qovia-description-zh": "知乎用户主页资料：昵称、粉丝数、回答数、文章数、认证信息、是否机构号、IP 属地、职业经历中的公司、一句话介绍和头像。 传 url_token（主页链接 zhihu.com/people/ 里的部分）。知乎此接口不返回关注数和获赞数。用户不存在时返回 404，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:zhihu", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.zhihu.user/" } }, "/v1/raw/zhihu/hot_list": { "get": { "operationId": "raw_zhihu_hot_list", "summary": "Zhihu hot list", "description": "Zhihu's hot list, about 30 questions in rank order: title and excerpt, answer and follower counts, rank, heat (「1848 万热度」 is 18480000), the new or hot label and a picture, as the same records as question detail (same ids). The list carries no view or comment counts (null).", "tags": [ "Zhihu" ], "parameters": [], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "id": "soc_zhi_66b674e3553a", "src": "social", "platform": "zhihu", "lang": "zh-CN", "text": "医保个人账户跨省共济落地全国，意味着什么？将带来哪些利好？\n近日，国家医保局上线医保钱包2.0版。自10月16日起，全国各省、自治区、直辖市及新疆生产建设兵团已全部上线运行，职工医保个人账户跨省共济在全国全面落地。 职工医保个人账户跨省共济，依托全国统一医保信息平台设立个人医保钱…", "author": null, "metrics": { "answers": 215, "followers": 1188, "views": null, "comments": null }, "extra": { "source_id": "2096149013556721446", "content_type": "question", "title": "医保个人账户跨省共济落地全国，意味着什么？将带来哪些利好？", "published_at": "2026-10-21T08:01:09+08:00", "rank": 1, "heat": 18480000, "heat_label": "1848 万热度", "label": "hot", "cover_url": "https://pica.zhimg.com/v2-d622fc703c850030325b874b3e4adcb9.png", "images": [], "url": "https://www.zhihu.com/question/2096149013556721446" }, "prov": { "hash": "0xfb11d7b41acae09a", "ts": "2026-10-21T23:45:00+08:00", "source": "live" } }, { "id": "soc_zhi_861c0f35534d", "src": "social", "platform": "zhihu", "lang": "zh-CN", "text": "樊振东发文称不管啥心态，都无法改变偷拍不尊重人的本质，如何看待以爱为名的侵扰？怎样算真正支持运动员？\n[图片]", "author": null, "metrics": { "answers": 252, "followers": 450, "views": null, "comments": null }, "extra": { "source_id": "2096173845665117950", "content_type": "question", "title": "樊振东发文称不管啥心态，都无法改变偷拍不尊重人的本质，如何看待以爱为名的侵扰？怎样算真正支持运动员？", "published_at": "2026-10-21T09:39:49+08:00", "rank": 2, "heat": 8120000, "heat_label": "812 万热度", "label": "hot", "cover_url": "https://pic1.zhimg.com/v2-d63563de8c04cec32b17c1638b15c8c8_1440w.png", "images": [], "url": "https://www.zhihu.com/question/2096173845665117950" }, "prov": { "hash": "0xfb064d5aead1056d", "ts": "2026-10-21T23:45:00+08:00", "source": "live" } } ], "prov": { "hash": "0xea5e6cf55179cb2b", "ts": "2026-10-21T23:45:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.zhihu.hot_list", "x-qovia-title-zh": "知乎热榜", "x-qovia-description-zh": "知乎首页热榜，按排名约 30 个问题：标题与摘要、回答数、关注数、排名、热度（「1848 万热度」为 18480000）、新上榜或热标记和配图，记录与问题详情相同（同一 id）。 热榜不带浏览量和评论数（为 null）。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:zhihu", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.zhihu.hot_list/" } }, "/v1/raw/zhihu/article_search": { "get": { "operationId": "raw_zhihu_article_search", "summary": "Zhihu content search", "description": "Keyword search over Zhihu answers and articles; answers are the same records as answer detail (same ids). Answers or articles only, sort by relevance, most upvoted or newest, filter by publish time (Zhihu applies it loosely). Pass the previous page's cursor and search_id back to continue (adjacent pages may repeat a few records: deduplicate by id); stop when has_more is false. No results answers empty and is not charged.", "tags": [ "Zhihu" ], "parameters": [ { "name": "keyword", "in": "query", "required": true, "description": "Search keyword", "x-qovia-description-zh": "搜索关键词", "schema": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "\\S", "examples": [ "deepseek" ] }, "example": "deepseek" }, { "name": "type", "in": "query", "required": false, "description": "Type: all (the default), answer (answers only) or article (articles only)", "x-qovia-description-zh": "类型：all 不限（默认）、answer 只看回答、article 只看文章", "schema": { "type": "string", "enum": [ "all", "answer", "article" ], "default": "all" } }, { "name": "sort", "in": "query", "required": false, "description": "Order: general (relevance, the default), most_liked (most upvoted) or latest", "x-qovia-description-zh": "排序：general 综合（默认）、most_liked 最多赞同、latest 最新发布", "schema": { "type": "string", "enum": [ "general", "most_liked", "latest" ], "default": "general" } }, { "name": "publish_time", "in": "query", "required": false, "description": "Published within: all (the default), a day, a week, a month, three months, half a year or a year", "x-qovia-description-zh": "发布时间：all 不限（默认）、day 一天内、week 一周内、month 一个月内、quarter 三个月内、half_year 半年内、year 一年内", "schema": { "type": "string", "enum": [ "all", "day", "week", "month", "quarter", "half_year", "year" ], "default": "all" } }, { "name": "cursor", "in": "query", "required": false, "description": "The cursor from the previous page's response", "x-qovia-description-zh": "取上一页响应的 cursor", "schema": { "type": "integer", "minimum": 0, "maximum": 1000, "default": 0 } }, { "name": "search_id", "in": "query", "required": false, "description": "The search_id from the previous page's response; leave it out for the first page", "x-qovia-description-zh": "取上一页响应的 search_id；第一页不传", "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "id": "soc_zhi_25f7dab19356", "src": "social", "platform": "zhihu", "lang": "zh-CN", "text": "这波开源再次把A\\和O吊起来锤！DS YES\n客观地说，对所以厂商间接的价格压力不小。对国产芯片，昇腾是最大的受益者；其他国产厂商面对的门槛被明显抬高了，国产厂商工作的兄弟们压力不小。\nDeepInfer 最早基于 vLLM 开发，现在的 vLLM 痕迹已经很少，调度器、输入准备…", "author": { "uid_hash": "a90a26b11344", "followers": 7645, "nickname": "不***猫", "user_id": "00000000000000000000000000000006", "url_token": "example-user-6" }, "metrics": { "likes": 378, "comments": 21, "saves": 136 }, "extra": { "source_id": "2095938107812193081", "content_type": "answer", "title": "如何看待DeepSeek于10月20日开源的推理框架DeepInfer？", "question_id": "2095923427483951981", "published_at": "2026-10-20T18:03:05+08:00", "updated_at": "2026-10-20T18:03:05+08:00", "images": [], "cover_url": null, "url": "https://www.zhihu.com/question/2095923427483951981/answer/2095938107812193081" }, "prov": { "hash": "0x33bd97c85d10ed12", "ts": "2026-10-21T23:45:00+08:00", "source": "live" } }, { "id": "soc_zhi_bcd8236779c2", "src": "social", "platform": "zhihu", "lang": "zh-CN", "text": "10月17日，DeepSeek开放了自研搜索API。提供搜索、抓取两个接口，开发者几行代码调用，AI就有了一双能看全网的眼睛。\n搜索一次半分钱，5块钱1000次，请求失败不计费。\nDeepSeek出手就干大事。互联网这30年，信息入口的钱有两种赚法，他选了第三种。\n一种是百度式，…", "author": { "uid_hash": "86304c158b44", "followers": 2037, "nickname": "小***论", "user_id": "00000000000000000000000000000007", "url_token": "example-user-7" }, "metrics": { "likes": 13, "comments": 1, "saves": 10 }, "extra": { "source_id": "2095207817133216122", "content_type": "article", "title": "实测DeepSeek搜索，半分钱撞了百度的命根子", "question_id": null, "published_at": "2026-10-18T17:41:10+08:00", "updated_at": "2026-10-18T17:41:10+08:00", "images": [ "https://pic1.zhimg.com/v2-e502668fbe60b2d00cee40968825f82c_r.jpg" ], "cover_url": "https://picx.zhimg.com/80/v2-e502668fbe60b2d00cee40968825f82c_qhd.jpg?source=4e949a73", "url": "https://zhuanlan.zhihu.com/p/2095207817133216122" }, "prov": { "hash": "0xb854e0bc66c21058", "ts": "2026-10-21T23:45:00+08:00", "source": "live" } } ], "cursor": 20, "has_more": true, "search_id": "600fd1f58c9c6284ffaac78be50e4d04", "prov": { "hash": "0x69388e0514229e45", "ts": "2026-10-21T23:45:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.zhihu.article_search", "x-qovia-title-zh": "知乎内容搜索", "x-qovia-description-zh": "按关键词搜索知乎的回答和文章，回答的记录与回答详情相同（同一 id）；可只看回答或文章，按综合、最多赞同或最新排序，按发布时间筛选（知乎的时间筛选较宽松）。 把上一页返回的 cursor 和 search_id 传回即可翻页（相邻页可能有少量重复，请按 id 去重），has_more 为 false 时停止。没有结果时返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:zhihu", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.zhihu.article_search/" } }, "/v1/raw/wechat/account_search": { "get": { "operationId": "raw_wechat_account_search", "summary": "WeChat official account search", "description": "Search WeChat official accounts by name or keyword: original ID (gh_…), name, WeChat ID, avatar, description, verifying organization and account type. One page of results, not paginated. kind picks subscription accounts, service accounts or both. No match answers empty and is not charged.", "tags": [ "WeChat Official Accounts & Channels" ], "parameters": [ { "name": "keyword", "in": "query", "required": true, "description": "Official account name or keyword", "x-qovia-description-zh": "公众号名称或关键词", "schema": { "type": "string", "minLength": 1, "maxLength": 50, "pattern": "\\S", "examples": [ "央视新闻" ] }, "example": "央视新闻" }, { "name": "kind", "in": "query", "required": false, "description": "Account type: subscription accounts (default), service accounts, or all (both, de-duplicated)", "x-qovia-description-zh": "账号类型：subscription 订阅号（默认）、service 服务号、all 两者合并去重", "schema": { "type": "string", "enum": [ "subscription", "service", "all" ], "default": "subscription" } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "id": "soc_wec_f66c11bf1ab8", "mp_id": "gh_example", "name": "示例公众号", "wechat_id": "example_account", "avatar": "https://example.com/avatar.jpg", "description": "账号简介", "verified": true, "verified_by": "示例机构", "type": "subscription" } ], "cursor": null, "has_more": false, "prov": { "hash": "0xe249fde3d74fb05b", "ts": "2026-10-21T17:30:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.005000", "balance_usd": "9.995000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.wechat.account_search", "x-qovia-title-zh": "微信公众号搜索", "x-qovia-description-zh": "按名称或关键词搜索微信公众号，返回原始 ID（gh_ 开头）、名称、微信号、头像、简介、认证主体和账号类型。 一次返回一页结果，不分页。kind 选择订阅号、服务号或两者合并。没有匹配结果时返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:wechat", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 5000, "usd_per_call": "0.005000", "usd_per_1k": "5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.wechat.account_search/" } }, "/v1/raw/wechat/articles": { "get": { "operationId": "raw_wechat_articles", "summary": "WeChat official account articles", "description": "History articles of one official account, newest first, one page per call: title, link, publish time, cover, digest, author, IP location and original/paid flags. Pass the previous page's cursor back unchanged to continue; stop when has_more is false. Take mp_id from raw.wechat.account_search. Empty pages are not charged.", "tags": [ "WeChat Official Accounts & Channels" ], "parameters": [ { "name": "mp_id", "in": "query", "required": true, "description": "Official account id (starts with gh_ or wxid_; the mp_id from raw.wechat.account_search)", "x-qovia-description-zh": "公众号 ID（gh_ 或 wxid_ 开头，raw.wechat.account_search 返回的 mp_id）", "schema": { "type": "string", "pattern": "^(gh|wxid)_[0-9a-zA-Z_]+$", "maxLength": 64, "examples": [ "gh_example" ] }, "example": "gh_example" }, { "name": "cursor", "in": "query", "required": false, "description": "The cursor returned by the previous page; omit it for the first page", "x-qovia-description-zh": "上一页返回的 cursor；第一页不传", "schema": { "type": "string", "maxLength": 1024 } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "id": "soc_wec_8d6202d11c59", "title": "示例文章", "url": "https://mp.weixin.qq.com/s/example", "published_at": "2026-10-21T09:30:00+08:00", "cover": "https://example.com/cover.jpg", "digest": "文章摘要", "author": "作者", "ip_region": "北京", "is_original": true, "is_paid": false, "reads_label": "10万+", "likes": 7562 } ], "cursor": "NEXT_OFFSET", "has_more": true, "prov": { "hash": "0x6a2bed4dd60ccaaa", "ts": "2026-10-21T17:30:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.005000", "balance_usd": "9.995000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.wechat.articles", "x-qovia-title-zh": "微信公众号历史文章", "x-qovia-description-zh": "一个公众号的历史文章，从新到旧，每次一页：标题、链接、发布时间、封面、摘要、作者、IP 属地、原创和付费标记。 把上一页返回的 cursor 原样传回即可翻页，has_more 为 false 时停止。mp_id 来自 raw.wechat.account_search。 空页不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:wechat", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 5000, "usd_per_call": "0.005000", "usd_per_1k": "5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.wechat.articles/" } }, "/v1/raw/wechat/article_metrics": { "get": { "operationId": "raw_wechat_article_metrics", "summary": "WeChat article metrics", "description": "Reads, likes, \"watching\" (在看), comments and shares of one official account article, with the time the numbers were taken. url is the article's mp.weixin.qq.com link (full or /s/ short form, e.g. the url from raw.wechat.articles). Charged only when metrics come back.", "tags": [ "WeChat Official Accounts & Channels" ], "parameters": [ { "name": "url", "in": "query", "required": true, "description": "Article link starting with https://mp.weixin.qq.com/ (or http://)", "x-qovia-description-zh": "文章链接，以 https://mp.weixin.qq.com/ 或 http://mp.weixin.qq.com/ 开头", "schema": { "type": "string", "pattern": "^https?://mp\\.weixin\\.qq\\.com/\\S+$", "maxLength": 2048, "examples": [ "https://mp.weixin.qq.com/s/example" ] }, "example": "https://mp.weixin.qq.com/s/example" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "id": "soc_wec_8d6202d11c59", "url": "https://mp.weixin.qq.com/s/example", "reads": 12345, "likes": 328, "watching": 76, "comments": 18, "shares": 42, "updated_at": "2026-10-21T10:00:00+08:00", "prov": { "hash": "0x40520e8eb57a2c12", "ts": "2026-10-21T17:30:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.005000", "balance_usd": "9.995000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.wechat.article_metrics", "x-qovia-title-zh": "微信文章互动数据", "x-qovia-description-zh": "一篇公众号文章的阅读、点赞、在看、评论和分享数，以及数据更新时间。url 填 mp.weixin.qq.com 的文章链接 （长链接或 /s/ 短链接均可，例如 raw.wechat.articles 返回的 url）。只有拿到数据时才计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:wechat", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 5000, "usd_per_call": "0.005000", "usd_per_1k": "5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.wechat.article_metrics/" } }, "/v1/raw/wechat/channel_search": { "get": { "operationId": "raw_wechat_channel_search", "summary": "WeChat Channels search", "description": "Search WeChat Channels (视频号) accounts by name or keyword: account identifier (username), name, bio and avatar. One page of results, not paginated. No match answers empty and is not charged.", "tags": [ "WeChat Official Accounts & Channels" ], "parameters": [ { "name": "keyword", "in": "query", "required": true, "description": "Channels account name or keyword", "x-qovia-description-zh": "视频号名称或关键词", "schema": { "type": "string", "minLength": 1, "maxLength": 50, "pattern": "\\S", "examples": [ "央视新闻" ] }, "example": "央视新闻" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "id": "soc_wec_e0ba85643ec6", "username": "finder_example", "name": "示例视频号", "signature": "视频号简介", "avatar": "https://example.com/avatar.jpg" } ], "cursor": null, "has_more": false, "prov": { "hash": "0x5a9a63dcd685da20", "ts": "2026-10-21T17:30:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.005000", "balance_usd": "9.995000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.wechat.channel_search", "x-qovia-title-zh": "微信视频号搜索", "x-qovia-description-zh": "按名称或关键词搜索微信视频号，返回视频号标识（username）、名称、简介和头像。一次返回一页结果，不分页。 没有匹配结果时返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:wechat", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 5000, "usd_per_call": "0.005000", "usd_per_1k": "5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.wechat.channel_search/" } }, "/v1/raw/wechat/account_search_v2": { "get": { "operationId": "raw_wechat_account_search_v2", "summary": "WeChat official account search V2", "description": "Search WeChat official accounts by name or keyword, returned as the platform answers in JSON: data holds result groups, and each group's subBoxes[].items lists the accounts with name (nickName), WeChat ID (aliasName), original ID (userName, gh_…), description, avatar, verifying organization and tags, plus the match total totalCount and the search term query. First page only (about 20 accounts), not paginated. Fast: usually about 2 seconds. No matching account answers empty. Only an answer with data is charged; an empty answer or an error is not.", "tags": [ "WeChat Official Accounts & Channels" ], "parameters": [ { "name": "keyword", "in": "query", "required": true, "description": "Official account name or keyword", "x-qovia-description-zh": "公众号名称或关键词", "schema": { "type": "string", "minLength": 1, "maxLength": 50, "pattern": "\\S", "examples": [ "人民日报" ] }, "example": "人民日报" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "data": [ { "title": "公众号", "type": 91, "totalCount": 200, "subBoxes": [ { "count": 1, "items": [ { "title": "人民日报", "desc": "参与、沟通、记录时代。", "docID": "2392014380", "jumpInfo": { "nickName": "人民日报", "aliasName": "rmrbwx", "userName": "gh_363b924965e9", "signature": "参与、沟通、记录时代。", "headImgUrl": "http://wx.qlogo.cn/mmhead/example/132", "verifyFlag": 1048 } } ] } ] } ], "lang": "zh_CN", "pageNumber": 1, "query": "人民日报", "ret": 0 }, "meta": { "billed": true, "charged_usd": "0.253530", "balance_usd": "9.746470", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.wechat.account_search_v2", "x-qovia-title-zh": "微信公众号搜索 V2", "x-qovia-description-zh": "按名称或关键词搜索微信公众号（按平台的原样 JSON 返回）：data 下是结果分组，每个分组的 subBoxes[].items 里是公众号，含名称（nickName）、微信号（aliasName）、原始 ID（userName，gh_ 开头）、简介、头像、认证主体和账号标签，另有命中总数 totalCount 和搜索词 query。 只返回第一页（约 20 个账号），不分页。响应较快，通常约 2 秒。 没有匹配的公众号时返回空结果。只对有数据的结果计费，空结果和出错都不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:wechat", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 253530, "usd_per_call": "0.253530", "usd_per_1k": "253.53" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.wechat.account_search_v2/" } }, "/v1/raw/wechat/channel_search_v2": { "get": { "operationId": "raw_wechat_channel_search_v2", "summary": "WeChat Channels search V2", "description": "Search WeChat Channels (视频号) accounts by name or keyword, returned as the platform answers in JSON: v2_info_list holds the matching accounts (contact has the account identifier username, name, bio, avatar, verification, region and live status, plus the highlighted name and bio), video_object_list the related videos (description, cover, play URL and engagement counts), and continue_flag says whether more exist. First page only, not paginated. Slower: usually about 4 seconds. No matching account leaves v2_info_list empty and answers empty. Only an answer with data is charged; an empty answer or an error is not.", "tags": [ "WeChat Official Accounts & Channels" ], "parameters": [ { "name": "keyword", "in": "query", "required": true, "description": "Channels account name or keyword", "x-qovia-description-zh": "视频号名称或关键词", "schema": { "type": "string", "minLength": 1, "maxLength": 50, "pattern": "\\S", "examples": [ "人民日报" ] }, "example": "人民日报" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "v2_info_list": [ { "contact": { "username": "v2_060000231003b20fa8example@finder", "nickname": "人民日报", "signature": "参与、沟通、记录时代。", "head_url": "https://wx.qlogo.cn/finderhead/example/0", "auth_info": { "auth_profession": "人民日报社", "customer_type": 9 }, "live_status": 1 }, "highlight_nickname": "人民日报", "highlight_signature": "参与、沟通、记录时代。" } ], "continue_flag": 1 }, "meta": { "billed": true, "charged_usd": "0.169020", "balance_usd": "9.830980", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.wechat.channel_search_v2", "x-qovia-title-zh": "微信视频号搜索 V2", "x-qovia-description-zh": "按名称或关键词搜索微信视频号（按平台的原样 JSON 返回）：v2_info_list 是匹配的视频号（contact 里有视频号标识 username、名称、简介、头像、认证信息、地区、直播状态，另有高亮后的名称和简介），video_object_list 是相关视频（描述、封面、播放地址和互动数），continue_flag 表示是否还有更多。 只返回第一页，不分页。响应较慢，通常约 4 秒。 没有匹配的视频号时 v2_info_list 为空，返回空结果。只对有数据的结果计费，空结果和出错都不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:wechat", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 169020, "usd_per_call": "0.169020", "usd_per_1k": "169.02" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.wechat.channel_search_v2/" } }, "/v1/raw/wechat/article_content_v3": { "get": { "operationId": "raw_wechat_article_content_v3", "summary": "WeChat article full text V3", "description": "The full text of one WeChat official account article, in the platform's own JSON: title, account name (nick_name) and ID (alias), author, digest (desc), publish time, cover (cdn_url), the body as plain text and as HTML, pictures and links in the body, copyright and IP location and more. Pass the mp.weixin.qq.com article link as url. Responses usually take about 3 seconds. The body text and HTML are in content and content_multi_text. A long article makes a large response, so allow for a big payload. An article that does not exist or was deleted answers 404 and is not charged. Only an answer with a title or body text is charged; an empty answer or an error is not.", "tags": [ "WeChat Official Accounts & Channels" ], "parameters": [ { "name": "url", "in": "query", "required": true, "description": "Article link starting with https://mp.weixin.qq.com/ (or http://)", "x-qovia-description-zh": "文章链接，以 https://mp.weixin.qq.com/ 或 http://mp.weixin.qq.com/ 开头", "schema": { "type": "string", "pattern": "^https?://mp\\.weixin\\.qq\\.com/\\S+$", "maxLength": 2048, "examples": [ "https://mp.weixin.qq.com/s/M6xY0oIbXI0IIkiKBG78Cw" ] }, "example": "https://mp.weixin.qq.com/s/M6xY0oIbXI0IIkiKBG78Cw" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "biz": "MjM5MDU1Mzg3Mw==", "mid": "2651763196", "idx": "1", "user_name": "gh_a7bbb71d655c", "nick_name": "中国新闻周刊", "alias": "chinanewsweekly", "title": "“丢了总统，逃去美国”", "desc": "争取时间", "author": "王晨晨", "create_time": "2026-10-30 07:51:30", "cdn_url": "https://mmbiz.qpic.cn/sz_mmbiz_jpg/oGLk9FLlibHez0bMh8h7kmd2n91sUzV0iboN13IuREh9QiboQNDHSrKDsHyGwLmUB19uSXhC9YIXrS69ichsUWzgoCSDGhv4wmaWdXmlB30TaFk/0?wx_fmt=jpeg", "url": "https://mp.weixin.qq.com/s?__biz=MjM5MDU1Mzg3Mw==&mid=2651763196&idx=1&sn=5ce2c318e5231a62948dc85ad1b43fc3&chksm=252824#rd", "pubtime": "2026-10-30 07:51:30", "content": "

争取时间

\n)", "x-qovia-description-zh": "笔记 ID（24 位十六进制，笔记链接 xiaohongshu.com/explore/ 里的 ID）", "schema": { "type": "string", "pattern": "^[0-9a-f]{24}$", "examples": [ "6a14846d000000000702d0d4" ] }, "example": "6a14846d000000000702d0d4" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "at_user_list": [], "desc": "高三后期。\n教室里最常见的饮料已经不是矿泉水了。\n⸻\n是咖啡。\n⸻\n以前上课。\n桌角摆着的是农夫山泉。\n或者可口可乐。\n…", "image_list": [ { "file_id": "notes_pre_post/1040g3k8320jnafonm8805pg9fsr1hjdj6tlakno", "height": 1274, "info_list": [], "live_photo": false, "stream": {}, "trace_id": "notes_pre_post/1040g3k8320jnafonm8805pg9fsr1hjdj6tlakno", "url": "http://sns-na-i27.xhscdn.com/notes_pre_post/1040g3k8320jnafonm8805pg9fsr1hjdj6tlakno?imageView2/2/w/1080/format/webp", "width": 1125 } ], "interact_info": { "collected": false, "collected_count": "1153", "comment_count": "1072", "followed": false, "liked": false, "liked_count": "11045", "nice_count": "11045", "relation": "none", "share_count": "359", "sticky": false }, "ip_location": "山东", "last_update_time": 1790824361, "note_id": "6a14846d000000000702d0d4", "share_info": { "un_share": false }, "tag_list": [ { "id": "5c50fb9b000000001c001a21", "link": "xhsdiscover://topic/v2/5c50fb9b4b25ed000140fa85?page_source=note_feed.click_new_big&source=normal&pre_source=tab_feed&topic_name=%E6%99%9A%E8%87%AA%E4%B9%A0", "name": "晚自习", "type": "topic" }, { "id": "5acc344be39faf54a1cbced9", "link": "xhsdiscover://topic/v2/5acc349cec9d13037b5bb162?page_source=note_feed.click_new_big&source=normal&pre_source=tab_feed&topic_name=%E9%AB%98%E8%80%83%E5%80%92%E8%AE%A1%E6%97%B6", "name": "高考倒计时", "type": "topic" }, { "id": "68216a510000000012019969", "link": "xhsdiscover://topic/v2/68216a520063000000000001?page_source=note_feed.click_new_big&source=normal&pre_source=tab_feed&topic_name=%E6%88%91%E7%9A%84%E9%AB%98%E4%B8%89%E8%AE%B0%E5%BF%86", "name": "我的高三记忆", "type": "topic" } ], "time": 1779729517, "title": "高三后期，班里开始靠咖啡续命了", "type": "normal", "user": { "avatar": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo3203ufh702q005pg9fsr1hjdj3nunboo?imageView2/2/w/80/format/jpg", "nick_name": "说***吗", "red_official_verify_type": 0, "user_id": "66097f36000000000600cdb3" } }, "meta": { "billed": true, "charged_usd": "0.005000", "balance_usd": "9.995000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.xiaohongshu.note", "x-qovia-title-zh": "小红书笔记详情", "x-qovia-description-zh": "一篇小红书笔记，data 是平台返回的笔记原始字段，不做改名、筛选或换算：note_id、title、desc（正文，含平台的 [话题] 标记）、type（normal 图文 / video 视频）、user、interact_info（点赞/评论/收藏/分享数，平台以字符串给出的精确值）、tag_list、image_list、ip_location、time（Unix 秒）等，视频笔记另有 video。 笔记不存在或已删除时返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:xiaohongshu", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 5000, "usd_per_call": "0.005000", "usd_per_1k": "5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.xiaohongshu.note/" } }, "/v1/raw/xiaohongshu/comments": { "get": { "operationId": "raw_xiaohongshu_comments", "summary": "Xiaohongshu (RedNote) note comments", "description": "First-level comments of a note, cursor-paginated. data holds the platform's original comment page: comments (each with id, content, like_count / like_view_count, sub_comment_count, a sub_comments preview, ip_location, time, pictures, user and so on), cursor, has_more, comment_count and the rest, unrenamed, unfiltered and unconverted; a commenter's user_id is given exactly as the platform gives it. sort=default (the default) follows Xiaohongshu's own order (pinned and popular first), about 5 a page; sort=latest is newest first, 10-15 a page, and its commenter fields and like counts differ somewhat from default's; the response is the reference. Pass the response's cursor back unchanged to continue (for latest it is a JSON text, also passed back unchanged); stop when has_more is false. Replies come from raw.xiaohongshu.comment_replies. A note without comments, or one that does not exist, answers empty and is not charged.", "tags": [ "Xiaohongshu (RedNote)" ], "parameters": [ { "name": "note_id", "in": "query", "required": true, "description": "Note ID (24 hex characters)", "x-qovia-description-zh": "笔记 ID（24 位十六进制）", "schema": { "type": "string", "pattern": "^[0-9a-f]{24}$", "examples": [ "6a14846d000000000702d0d4" ] }, "example": "6a14846d000000000702d0d4" }, { "name": "sort", "in": "query", "required": false, "description": "Order: default is Xiaohongshu's own (pinned and popular first), latest is newest first", "x-qovia-description-zh": "排序：default 小红书默认顺序（置顶、热门在前），latest 从新到旧", "schema": { "type": "string", "enum": [ "default", "latest" ], "default": "default" } }, { "name": "cursor", "in": "query", "required": false, "description": "The cursor from the previous page's response, passed back unchanged (it may be a JSON text); omit it for the first page", "x-qovia-description-zh": "上一页响应里的 cursor，原样传回（可能是一段 JSON 文本）；第一页不传", "schema": { "type": "string", "pattern": "^([0-9a-f]{24}|\\{.{1,600}\\})?$", "default": "" } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "comment_count": 1072, "comment_count_l1": 660, "comments": [ { "at_users": [], "comment_type": 0, "content": "无酸小甜豆黄油曲奇拼配", "id": "6ab72c400000000008034e99", "ip_location": "山东", "like_count": 0, "like_view_count": "0", "liked": false, "note_id": "6a14846d000000000702d0d4", "status": 4, "sub_comment_count": 0, "sub_comments": [], "time": 1790389313000, "user": { "ai_agent": false, "image": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo3203ufh702q005pg9fsr1hjdj3nunboo?imageView2/2/w/120/format/jpg", "nickname": "说***吗", "user_id": "66097f36000000000600cdb3" } }, { "at_users": [], "comment_type": 0, "content": "喝了晚上还能睡着怎么解", "id": "6a17eab1000000002902f300", "ip_location": "陕西", "like_count": 0, "like_view_count": "1918", "liked": false, "note_id": "6a14846d000000000702d0d4", "status": 0, "sub_comment_count": 62, "sub_comments": [ { "at_users": [], "comment_type": 0, "content": "你是上过高中的[笑哭R]", "id": "6a18470d0000000027015f08", "ip_location": "浙江", "like_count": 0, "like_view_count": "1070", "liked": false, "note_id": "6a14846d000000000702d0d4", "status": 0, "sub_comment_count": 0, "target_comment": { "id": "6a17eab1000000002902f300" }, "time": 1779975950000, "user": { "ai_agent": false, "image": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo321tbsffv70605nq0dpqg9b8qfk5gn3o?imageView2/2/w/120/format/jpg", "nickname": "野***.", "user_id": "5f406e75000000000100ad1a" } } ], "time": 1779952305000, "user": { "ai_agent": false, "image": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo31u2d9gse780049mrq6u17f8s0fscipo?imageView2/2/w/120/format/jpg", "nickname": "***嘟", "user_id": "5978bc135e87e717fbd0bd1c" } } ], "cursor": "6a1b938c000000002b025bef", "has_more": true, "time": 1792588936009 }, "meta": { "billed": true, "charged_usd": "0.005000", "balance_usd": "9.995000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.xiaohongshu.comments", "x-qovia-title-zh": "小红书笔记评论", "x-qovia-description-zh": "一篇笔记的一级评论，按游标翻页。data 是平台返回的评论页原始字段：comments（每条含 id、content、like_count / like_view_count、sub_comment_count、sub_comments 预览、ip_location、time、pictures、user 等）、cursor、has_more、comment_count 等，不做改名、筛选或换算，评论者的 user_id 按平台原样给出。 sort 为 default（默认）时按小红书的默认顺序（置顶、热门在前），每页约 5 条；为 latest 时从新到旧，每页 10–15 条，评论者的字段与点赞数的给法和 default 不完全相同，以返回为准。 把响应里的 cursor 原样传回即可翻页（latest 的 cursor 是一段 JSON 文本，同样原样传回），has_more 为 false 时停止。回复用 raw.xiaohongshu.comment_replies 获取。没有评论或笔记不存在时返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:xiaohongshu", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 5000, "usd_per_call": "0.005000", "usd_per_1k": "5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.xiaohongshu.comments/" } }, "/v1/raw/xiaohongshu/comment_replies": { "get": { "operationId": "raw_xiaohongshu_comment_replies", "summary": "Xiaohongshu (RedNote) comment replies", "description": "Replies (second-level comments) under one first-level comment, oldest first, about 5 a page. data holds the platform's original reply page: comments (each with id, content, like_count, time, user, target_comment and so on), cursor, has_more and the rest, unrenamed, unfiltered and unconverted. comment_id is a comment id from raw.xiaohongshu.comments. Pass the response's cursor (a JSON text) back unchanged to continue; stop when has_more is false. No replies answers empty and is not charged.", "tags": [ "Xiaohongshu (RedNote)" ], "parameters": [ { "name": "note_id", "in": "query", "required": true, "description": "Note ID (24 hex characters)", "x-qovia-description-zh": "笔记 ID（24 位十六进制）", "schema": { "type": "string", "pattern": "^[0-9a-f]{24}$", "examples": [ "6a14846d000000000702d0d4" ] }, "example": "6a14846d000000000702d0d4" }, { "name": "comment_id", "in": "query", "required": true, "description": "First-level comment ID (a cid from raw.xiaohongshu.comments)", "x-qovia-description-zh": "一级评论 ID（raw.xiaohongshu.comments 返回的 cid）", "schema": { "type": "string", "pattern": "^[0-9a-f]{24}$", "examples": [ "6a17eab1000000002902f300" ] }, "example": "6a17eab1000000002902f300" }, { "name": "cursor", "in": "query", "required": false, "description": "The cursor from the previous page's response, passed back unchanged (it may be a JSON text); omit it for the first page", "x-qovia-description-zh": "上一页响应里的 cursor，原样传回（可能是一段 JSON 文本）；第一页不传", "schema": { "type": "string", "pattern": "^([0-9a-f]{24}|\\{.{1,600}\\})?$", "default": "" } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "comments": [ { "at_users": [], "biz_label": { "group_invite": "false", "product_review": false, "rich_text": "unknown" }, "collected": false, "comment_type": 0, "content": "你是上过高中的[笑哭R]", "downvoted": false, "friend_liked_msg": "", "hidden": false, "id": "6a18470d0000000027015f08", "like_count": 1070, "liked": false, "note_id": "6a14846d000000000702d0d4", "score": 0, "share_strategy": 0, "show_tags": [], "show_tags_v2": [], "show_type": "common", "status": 0, "target_comment": { "id": "6a17eab1000000002902f300", "status": 0, "user": { "additional_tags": {}, "ai_agent": false, "current_user": "false", "images": "https://sns-avatar-qc-ae.rednotecdn.com/avatar/1040g2jo31u2d9gse780049mrq6u17f8s0fscipo?imageView2/2/w/120/format/jpg", "level": { "image": "" }, "nickname": "***嘟", "red_id": "157***21", "userid": "a72b49f3d6cc21160fb79e3d8cd15" } }, "time": 1779975950, "translation_strategy": 10, "user": { "additional_tags": {}, "ai_agent": false, "current_user": "false", "images": "https://sns-avatar-qc-ae.rednotecdn.com/avatar/1040g2jo321tbsffv70605nq0dpqg9b8qfk5gn3o?imageView2/2/w/120/format/jpg", "level": { "image": "" }, "nickname": "野***.", "red_id": "397***18", "userid": "a825b85b46c080f44708dae3f1922" } }, { "at_users": [], "biz_label": { "group_invite": "false", "product_review": false, "rich_text": "unknown" }, "collected": false, "comment_type": 0, "content": "其实早读喝的中午午休睡得可香", "downvoted": false, "friend_liked_msg": "", "hidden": false, "id": "6a18614d000000002a02c11f", "like_count": 259, "liked": false, "note_id": "6a14846d000000000702d0d4", "score": 0, "share_strategy": 0, "show_tags": [], "show_tags_v2": [], "show_type": "common", "status": 0, "target_comment": { "id": "6a17eab1000000002902f300", "status": 0, "user": { "additional_tags": {}, "ai_agent": false, "current_user": "false", "images": "https://sns-avatar-qc-ae.rednotecdn.com/avatar/1040g2jo31u2d9gse780049mrq6u17f8s0fscipo?imageView2/2/w/120/format/jpg", "level": { "image": "" }, "nickname": "***嘟", "red_id": "157***21", "userid": "a72b49f3d6cc21160fb79e3d8cd15" } }, "time": 1779982670, "translation_strategy": 10, "user": { "additional_tags": {}, "ai_agent": false, "current_user": "false", "images": "https://sns-avatar-qc-ae.rednotecdn.com/avatar/1040g2jo31vk4mjh02g605oqsepbm5ctmd7heo6g?imageView2/2/w/120/format/jpg", "level": { "image": "" }, "nickname": "不***遇", "red_id": "941***82", "userid": "ae2af77fd483f752d7ba12607f864" } } ], "cursor": "{\"cursor\":\"6a1bcaf5000000002a02cff8\",\"index\":2}", "has_more": true, "page_context": "" }, "meta": { "billed": true, "charged_usd": "0.005000", "balance_usd": "9.995000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.xiaohongshu.comment_replies", "x-qovia-title-zh": "小红书评论回复", "x-qovia-description-zh": "一条一级评论下的回复（二级评论），从旧到新，每页约 5 条。data 是平台返回的回复页原始字段：comments（每条含 id、content、like_count、time、user、target_comment 等）、cursor、has_more 等，不做改名、筛选或换算。 comment_id 是 raw.xiaohongshu.comments 返回的评论 id。把响应里的 cursor（一段 JSON 文本）原样传回即可翻页，has_more 为 false 时停止。没有回复时返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:xiaohongshu", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 5000, "usd_per_call": "0.005000", "usd_per_1k": "5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.xiaohongshu.comment_replies/" } }, "/v1/raw/xiaohongshu/user": { "get": { "operationId": "raw_xiaohongshu_user", "summary": "Xiaohongshu (RedNote) user profile", "description": "A Xiaohongshu user's profile. data holds the platform's original profile fields, unrenamed, unfiltered and unconverted: userid, red_id (the Xiaohongshu ID), nickname, fans, follows, interactions, note_num_stat, gender, ip_location, desc, imageb and so on. A user that does not exist answers 404 and is not charged.", "tags": [ "Xiaohongshu (RedNote)" ], "parameters": [ { "name": "user_id", "in": "query", "required": true, "description": "User ID (24 hex characters, the ID in xiaohongshu.com/user/profile/; not the Xiaohongshu ID)", "x-qovia-description-zh": "用户 ID（24 位十六进制，主页链接 xiaohongshu.com/user/profile/ 里的 ID；不是小红书号）", "schema": { "type": "string", "pattern": "^[0-9a-f]{24}$", "examples": [ "60014bac0000000001009be4" ] }, "example": "60014bac0000000001009be4" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "avatar_handle_entry_list": [], "avatar_like_status": false, "avatar_pendant": { "current_user_pendant": false, "current_user_pet": false }, "banner_info": { "bg_color": "a5938c", "image": "http://sns-avatar-qc.rednotecdn.com/user_banner/1040g2k030qvbq59th8005o019em096v4ca64f10?imageView2/2/w/540/format/jpg&ap=28&sc=USR_BG", "like_status": false }, "block_view_from_user": false, "block_view_to_user": false, "blocked": false, "blocking": false, "brand_account_info": { "conversions": [ { "icon": "https://picasso-static.xiaohongshu.com/fe-platform/c17fa18d287ca13418e1a6ae86270895a10c9d78.png", "id": "11", "is_red_shop": false, "is_shop": false, "link": "xhsdiscover://message/userPublicGroupList?user_id=60014bac0000000001009be4&username=TA", "name": "群聊", "sub_title": "查看详情" }, { "icon": "https://picasso-static.xiaohongshu.com/fe-platform/abb79105a1ec9de13a055f2875607c4824263d89.png", "id": "13", "is_red_shop": false, "is_shop": false, "link": "xhsdiscover://live_goods_development_page?source=PROFILE&host_id=60014bac0000000001009be4&trailer_auto_subscribe=0", "name": "直播动态", "sub_title": "去预约 10.22 10:01" } ] }, "collected": 8813, "collected_book_num": 0, "collected_brand_num": 0, "collected_movie_num": 0, "collected_notes_num": 0, "collected_poi_num": 0, "collected_product_num": 0, "collected_tags_num": 0, "college_info": { "college_name": "安徽农业大学", "enrollment_year": 2023 }, "community_rule_url": "https://www.xiaohongshu.com/user/community-rule", "default_collection_tab": "note", "desc": "我是木灵\n线下茶艺老师\n直播课周一至周五\n上午10点-13点", "desc_at_users": [], "fans": 10512, "follows": 1, "fstatus": "none", "gender": 1, "hula_tabs": { "all_show_tab_config": [ { "tab_id": "note", "tab_index_weight": 0, "tab_name": "笔记" }, { "tab_id": "atMe", "tab_index_weight": 12, "tab_name": "标记" } ], "tab_id_selected": "note" }, "identity_deeplink": "xhsdiscover://rn/app-settings/official/certification/details?type=2&user_id=60014bac0000000001009be4&is_mcn=false", "identity_label_migrated": false, "imageb": "https://sns-avatar-qc-ae.rednotecdn.com/avatar/1040g2jo30pmiu3qp6k005o019em096v44mekl3g?imageView2/2/w/540/format/webp", "images": "https://sns-avatar-qc-ae.rednotecdn.com/avatar/1040g2jo30pmiu3qp6k005o019em096v44mekl3g?imageView2/2/w/360/format/webp", "interactions": [ { "count": 1, "is_private": true, "name": "关注", "toast": "该用户已设置关注列表不可见", "type": "follows" }, { "count": 10512, "is_private": true, "name": "粉丝", "toast": "该用户已设置粉丝列表不可见", "type": "fans" }, { "count": 27720, "is_private": false, "name": "获赞与收藏", "toast": "", "type": "interaction" } ], "ip_location": "天津", "is_login_user_pro_account": false, "is_recommend_level_illegal": false, "level": { "image_link": "", "number": 0 }, "liked": 18907, "location": "中国 天津 津南", "location_jump": true, "mute_view_to_user": false, "nboards": 0, "ndiscovery": 430, "nickname": "木***师", "note_num_stat": { "collected": 8813, "liked": 18907, "posted": 430 }, "real_name_deep_target": 1, "real_name_info": "", "recommend_info": "", "recommend_info_icon": "", "red_club_info": { "red_club": false, "red_club_level": 0, "red_club_url": "https://www.xiaohongshu.com/store/mc/landing", "redclubscore": 0 }, "red_id": "Bel***83", "red_official_verified": false, "red_official_verify_base_info": "", "red_official_verify_content": "", "red_official_verify_type": 0, "remark_name": "", "result": { "code": 0, "message": "success", "success": true }, "sec_account_deeplink": "xhsdiscover://rn/accounts/account-detail?targetId=60014bac0000000001009be4&new_page_exp=1&rn_min_version=3.3.6", "seller_info": { "can_process_coupon": true, "display_modules": { "official": true }, "is_tab_goods_first": true, "store_id": "625113963801e1000190ca26", "tab_code_names": [ "TRADE_COMMODITY_TAB", "TRADE_SELLER_INFO" ], "tab_goods_api_version": 2, "tab_goods_name": "商品" }, "share_info": { "content": "我是木灵\n线下茶艺老师\n直播课周一至周五\n上午10点-13点", "store_link": "xhsdiscover://rn/lancer/shop-detail/625113963801e1000190ca26", "title": "木灵老师" }, "share_info_v2": { "content": "粉丝: 1.1万\n获赞与收藏: 2.8万", "ecom_content": "快来木灵老师的店里逛逛！已有6262人买过了！", "ecom_share_link": "https://www.xiaohongshu.com/user/profile/60014bac0000000001009be4?tab=goods&channelType=share_outside", "ecom_title": "木灵老师的店铺", "title": "@木灵老师的个人主页" }, "share_link": "https://www.xiaohongshu.com/user/profile/60014bac0000000001009be4?xsec_token=YBgvXArWi74H3r7dAuJ41l2ZuVsEBC6hparuUPvHH-v5E=&xsec_source=app_share", "show_extra_info_button": false, "tab_public": { "collection": false, "collection_board": true, "collection_note": true, "seed": true }, "tab_visible": { "atme": true, "collect": false, "goods": false, "like": false, "note": true, "seed": true }, "tags": [ { "icon": "http://sns-i14-ae.rednotecdn.com/icons/user/gender-female-v1.png", "name": "天蝎座", "tag_type": "info" }, { "name": "天津津南", "tag_type": "location" }, { "name": "茶艺师", "tag_type": "profession" } ], "user_desc_info": { "desc": "我是木灵\n线下茶艺老师\n直播课周一至周五\n上午10点-13点", "desc_at_users": [], "desc_keywords_switch": true, "desc_with_placeholder": "我是木灵\n线下茶艺老师\n直播课周一至周五\n上午10点-13点" }, "user_role_type": 6, "user_widget_switch": false, "userid": "60014bac0000000001009be4", "zhong_tong_bar_info": { "conversions": [ { "icon": "https://picasso-static.xiaohongshu.com/fe-platform/abb79105a1ec9de13a055f2875607c4824263d89.png", "id": "13", "link": "xhsdiscover://live_goods_development_page?source=PROFILE&host_id=60014bac0000000001009be4&trailer_auto_subscribe=0", "name": "直播动态", "sub_title": "去预约 10.22 10:01" }, { "icon": "https://picasso-static.xiaohongshu.com/fe-platform/c17fa18d287ca13418e1a6ae86270895a10c9d78.png", "id": "11", "link": "xhsdiscover://message/userPublicGroupList?user_id=60014bac0000000001009be4&username=TA", "name": "群聊", "sub_title": "查看详情" } ] } }, "meta": { "billed": true, "charged_usd": "0.005000", "balance_usd": "9.995000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.xiaohongshu.user", "x-qovia-title-zh": "小红书用户详情", "x-qovia-description-zh": "小红书用户主页，data 是平台返回的用户资料原始字段，不做改名、筛选或换算：userid、red_id（小红书号）、nickname、fans、follows、interactions、note_num_stat、gender、ip_location、desc、imageb 等。 用户不存在时返回 404，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:xiaohongshu", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 5000, "usd_per_call": "0.005000", "usd_per_1k": "5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.xiaohongshu.user/" } }, "/v1/raw/xiaohongshu/user_notes": { "get": { "operationId": "raw_xiaohongshu_user_notes", "summary": "Xiaohongshu (RedNote) user notes", "description": "Notes a user posted, pinned ones first and then newest first, about 20 a page. data holds the platform's original note list: notes (each with id, title, desc, type, likes, comments_count, collected_count, share_count, create_time, images_list, video_info_v2, user, cursor, sticky and so on) and has_more, unrenamed, unfiltered and unconverted. To continue, pass the last note's cursor (it is that note's id) back; stop when has_more is false. A user without notes, or one that does not exist, answers empty and is not charged.", "tags": [ "Xiaohongshu (RedNote)" ], "parameters": [ { "name": "user_id", "in": "query", "required": true, "description": "User ID (24 hex characters)", "x-qovia-description-zh": "用户 ID（24 位十六进制）", "schema": { "type": "string", "pattern": "^[0-9a-f]{24}$", "examples": [ "60014bac0000000001009be4" ] }, "example": "60014bac0000000001009be4" }, { "name": "cursor", "in": "query", "required": false, "description": "The cursor of the last note on the previous page (that note's id), passed back unchanged; omit it for the first page", "x-qovia-description-zh": "上一页最后一篇笔记的 cursor（该笔记的 id），原样传回；第一页不传", "schema": { "type": "string", "pattern": "^[0-9a-f]{24}$" } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "has_more": true, "notes": [ { "advanced_widgets_groups": { "groups": [ { "fetch_types": [ "guos_test", "note_next_step" ], "mode": 1 }, { "fetch_types": [ "guos_test", "vote_stickers" ], "mode": 0 } ] }, "ats": [], "collected_count": 107, "comments_count": 3, "create_time": 1693699228, "cursor": "64f33666000000001e032bdb", "desc": "茶为瑞草魁香，是国之嘉叶，更是融于日常的饮品。\n中华文化源远流长、灿烂辉煌。\n在5000 多年的文明史中孕育了大量优秀的…", "display_title": "斟茶礼，茶桌上的礼仪，你懂吗？", "guide_context": "{\"show_goods_c2c\":false}", "has_music": false, "id": "64f33666000000001e032bdb", "images_list": [ { "fileid": "1040g00830rimgdqmii005o019em096v4b842tco", "height": 1440, "original": "", "trace_id": "1040g00830rimgdqmii005o019em096v4b842tco", "url": "https://sns-i14-ae.rednotecdn.com/1040g00830rimgdqmii005o019em096v4b842tco?imageView2/2/w/576/format/heif/q/58|imageMogr2/strip&redImage/frame/0&ap=12&sc=USR_PRV&sign=024e7bca01ab61f655a9685f1413c890&t=6ad8bce1", "url_size_large": "https://sns-i14-ae.rednotecdn.com/1040g00830rimgdqmii005o019em096v4b842tco?imageView2/2/w/1440/format/heif/q/45&redImage/frame/0&ap=12&sc=USR_DTL&sign=024e7bca01ab61f655a9685f1413c890&t=6ad8bce1", "width": 1080 } ], "infavs": false, "inlikes": false, "is_goods_note": false, "last_update_time": 1752281739, "likes": 114, "nice_count": 0, "niced": false, "price": 0, "recommend": { "desc": "", "icon": "", "target_id": "", "target_name": "", "track_id": "", "type": "" }, "share_count": 17, "sticky": true, "time_desc": "2023-09-03", "title": "斟茶礼，茶桌上的礼仪，你懂吗？", "type": "normal", "user": { "followed": false, "fstatus": "none", "images": "https://sns-avatar-qc-ae.rednotecdn.com/avatar/1040g2jo30pmiu3qp6k005o019em096v44mekl3g?imageView2/2/w/80/format/jpg", "nickname": "木***师", "red_official_verify_type": 0, "userid": "60014bac0000000001009be4" }, "view_count": 0, "widgets_context": "{\"flags\":{},\"author_id\":\"60014bac0000000001009be4\",\"author_n…" }, { "advanced_widgets_groups": { "groups": [ { "fetch_types": [ "guos_test", "note_next_step" ], "mode": 1 }, { "fetch_types": [ "guos_test", "vote_stickers" ], "mode": 0 } ] }, "ats": [], "collected_count": 925, "comments_count": 16, "create_time": 1674917214, "cursor": "63d5355e000000001a01e8f9", "desc": "中国基础六大茶类的分类、工艺、特点\n中国的茶叶种类很多，分类也自然很多，但被大家熟知和广泛认同的就是按照茶的氧化程度与加…", "display_title": "爱喝茶的人都收藏了，中国茶基础知识", "guide_context": "{\"show_goods_c2c\":false}", "has_music": false, "id": "63d5355e000000001a01e8f9", "images_list": [ { "fileid": "1040g00830rim4dc3ik005o019em096v48mdfmi8", "height": 1440, "original": "", "trace_id": "1040g00830rim4dc3ik005o019em096v48mdfmi8", "url": "https://sns-i14-ae.rednotecdn.com/1040g00830rim4dc3ik005o019em096v48mdfmi8?imageView2/2/w/576/format/heif/q/58|imageMogr2/strip&redImage/frame/0&ap=12&sc=USR_PRV&sign=51383d3a8235aa31bcc2b592e2815a44&t=6ad8bce1", "url_size_large": "https://sns-i14-ae.rednotecdn.com/1040g00830rim4dc3ik005o019em096v48mdfmi8?imageView2/2/w/1440/format/heif/q/45&redImage/frame/0&ap=12&sc=USR_DTL&sign=51383d3a8235aa31bcc2b592e2815a44&t=6ad8bce1", "width": 1080 } ], "infavs": false, "inlikes": false, "is_goods_note": false, "last_update_time": 1787030141, "likes": 1148, "nice_count": 0, "niced": false, "price": 0, "recommend": { "desc": "", "icon": "", "target_id": "", "target_name": "", "track_id": "", "type": "" }, "share_count": 159, "sticky": true, "time_desc": "2023-01-28", "title": "爱喝茶的人都收藏了，中国茶基础知识", "type": "normal", "user": { "followed": false, "fstatus": "none", "images": "https://sns-avatar-qc-ae.rednotecdn.com/avatar/1040g2jo30pmiu3qp6k005o019em096v44mekl3g?imageView2/2/w/80/format/jpg", "nickname": "木***师", "red_official_verify_type": 0, "userid": "60014bac0000000001009be4" }, "view_count": 0, "widgets_context": "{\"flags\":{},\"author_id\":\"60014bac0000000001009be4\",\"author_n…" } ], "tags": [] }, "meta": { "billed": true, "charged_usd": "0.005000", "balance_usd": "9.995000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.xiaohongshu.user_notes", "x-qovia-title-zh": "小红书用户笔记列表", "x-qovia-description-zh": "一个用户发布的笔记，置顶笔记在前，其余从新到旧，每页约 20 篇。data 是平台返回的笔记列表原始字段：notes（每篇含 id、title、desc、type、likes、comments_count、collected_count、share_count、create_time、images_list、video_info_v2、user、cursor、sticky 等）、has_more，不做改名、筛选或换算。 翻页：把最后一篇笔记的 cursor 传回（它就是该篇笔记的 id），has_more 为 false 时停止。没有笔记或用户不存在时返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:xiaohongshu", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 5000, "usd_per_call": "0.005000", "usd_per_1k": "5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.xiaohongshu.user_notes/" } }, "/v1/raw/xiaohongshu/search": { "get": { "operationId": "raw_xiaohongshu_search", "summary": "Xiaohongshu (RedNote) note search", "description": "Search Xiaohongshu notes by keyword, 20 a page. data holds the platform's original search result: items (each with model_type and note; a note has id, xsec_token, title, desc, type, liked_count, comments_count, collected_count, shared_count, timestamp, images_list, video_info_v2, user and so on) and the platform's other fields, unrenamed, unfiltered and unconverted; result items that are not notes (model_type other than note) are kept as they come, and only notes are charged. Sort by relevance, newest, most liked, most commented or most saved; filter by note type and publish time. Page with page; the response has no has_more, so go on until a page comes back empty (not charged).", "tags": [ "Xiaohongshu (RedNote)" ], "parameters": [ { "name": "keyword", "in": "query", "required": true, "description": "Search keyword", "x-qovia-description-zh": "搜索关键词", "schema": { "type": "string", "minLength": 1, "maxLength": 50, "pattern": "\\S", "examples": [ "咖啡" ] }, "example": "咖啡" }, { "name": "page", "in": "query", "required": false, "description": "Page number, from 1; stop when a page comes back empty", "x-qovia-description-zh": "页码，从 1 开始；翻到没有结果时停止", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1 } }, { "name": "sort", "in": "query", "required": false, "description": "Order: general (relevance, the default), latest, most_liked, most_commented or most_saved", "x-qovia-description-zh": "排序：general 综合（默认）、latest 最新、most_liked 最多点赞、most_commented 最多评论、most_saved 最多收藏", "schema": { "type": "string", "enum": [ "general", "latest", "most_liked", "most_commented", "most_saved" ], "default": "general" } }, { "name": "note_type", "in": "query", "required": false, "description": "Note type: all (the default), video or image notes", "x-qovia-description-zh": "笔记类型：all 不限（默认）、video 视频笔记、image 图文笔记", "schema": { "type": "string", "enum": [ "all", "video", "image" ], "default": "all" } }, { "name": "note_time", "in": "query", "required": false, "description": "Published within: all (the default), a day, a week, a month or a year", "x-qovia-description-zh": "发布时间：all 不限（默认）、day 一天内、week 一周内、month 一个月内、year 一年内", "schema": { "type": "string", "enum": [ "all", "day", "week", "month", "year" ], "default": "all" } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "ai_mode_enable": false, "can_cut": false, "cur_cut_number": 0, "dqa_authorized_user_by_shared": false, "extra_info": { "atmosphere_v3_enable": "1" }, "is_broad_query": true, "items": [ { "mix_track_id": "NOTE__69f7dc410000000035021f62__2h1xudxi36i2kzu0g9340__咖啡", "model_type": "note", "new_help_style": false, "note": { "advanced_widgets_groups": { "groups": [ { "fetch_types": [ "guos_test", "note_next_step" ], "mode": 1 }, { "fetch_types": [ "guos_test", "vote_stickers" ], "mode": 0 } ] }, "click_score": 0.03819393366575241, "collected": false, "collected_count": 966, "comments_count": 1570, "corner_tag_info": [ { "icon": "", "location": -1, "style": 0, "text": "RANdXp0+VM73eUyvLVw+K4LXoF6C8zUygl9n+arZ59HzL3TswBWWAWOqL9sf…", "text_en": "", "type": "ubt_sig_token" }, { "icon": "http://picasso-static.xiaohongshu.com/fe-platform/e9b67af62f67d9d6cfac936f96ad10a85fdb868e.png", "location": 5, "style": 0, "text": "05-07", "text_en": "05-07", "type": "publish_time" } ], "cover_image_index": 0, "debug_info_str": "", "desc": "图一开封的地方，真的字体会比较清爽，假的是比较粗的，下面的8，真的是相对会扁一点，两个在一起对比有很明显的不同 图二很明", "extract_text_enabled": 0, "geo_info": { "distance": "" }, "has_music": false, "id": "69f7dc410000000035021f62", "images_list": [ { "fileid": "notes_pre_post/1040g3k831vnnp4k7hmd04a1oi1mr8elqsn8nfuo", "height": 2560, "need_load_original_image": false, "original": "", "trace_id": "notes_pre_post/1040g3k831vnnp4k7hmd04a1oi1mr8elqsn8nfuo", "url": "https://sns-na-i2.xhscdn.com/notes_pre_post/1040g3k831vnnp4k7hmd04a1oi1mr8elqsn8nfuo?imageView2/2/w/608/format/heif/q/56|imageMogr2/strip&redImage/frame/0/enhance/4&ap=5&sc=SRH_PRV&sign=d1255ac1c4bf31cc41bf6055f160ecbe&t=6ad8bc4c", "url_size_large": "https://sns-na-i2.xhscdn.com/notes_pre_post/1040g3k831vnnp4k7hmd04a1oi1mr8elqsn8nfuo?imageView2/2/w/1440/format/heif/q/45&redImage/frame/0&ap=5&sc=SRH_DTL&sign=d1255ac1c4bf31cc41bf6055f160ecbe&t=6ad8bc4c", "width": 1920 } ], "interaction_area": { "status": false, "text": "1205", "type": 1 }, "last_update_time": 1778137469, "liked": false, "liked_count": 1205, "nice_count": 0, "niced": false, "note_attributes": [], "result_from": "", "shared_count": 287, "tag_info": { "title": "", "type": "" }, "timestamp": 1777851457, "title": "真假摩可纳咖啡对比（一）", "type": "normal", "update_time": 1778137512000, "user": { "followed": false, "images": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo31khvup72iu6g4a1oi1mr8elqqcbfmbo?imageView2/2/w/80/format/jpg", "nickname": "J***y", "red_id": "493***96", "red_official_verified": false, "red_official_verify_type": 0, "show_red_official_verify_icon": false, "track_duration": 0, "userid": "5a916db4e8ac2b54e8b53aba" }, "widgets_context": "{\"flags\":{},\"author_id\":\"5a916db4e8ac2b54e8b53aba\",\"author_n…", "xsec_token": "YB-Ez6A0sUGde5rEnUs_DNj_OvWS4G9u7E3deUxhBsV3w=" } }, { "mix_track_id": "NOTE__699ac514000000001a023963__2h1xudxi36i2kzu0g9340__咖啡", "model_type": "note", "new_help_style": false, "note": { "advanced_widgets_groups": { "groups": [ { "fetch_types": [ "guos_test", "note_next_step" ], "mode": 1 }, { "fetch_types": [ "guos_test", "vote_stickers" ], "mode": 0 } ] }, "click_score": 0.004283426329493523, "collected": false, "collected_count": 43, "comments_count": 148, "corner_tag_info": [ { "icon": "", "location": -1, "style": 0, "text": "RAXvgVeqGkBM4UA2L7CFkMSkgBg9t+BCeOmgJb32iGUC8L6wDeKMT3MxNPil…", "text_en": "", "type": "ubt_sig_token" }, { "icon": "http://picasso-static.xiaohongshu.com/fe-platform/e9b67af62f67d9d6cfac936f96ad10a85fdb868e.png", "location": 5, "style": 0, "text": "02-22", "text_en": "02-22", "type": "publish_time" } ], "cover_image_index": 0, "debug_info_str": "", "desc": "回来过年想约老友来坐坐。结果老友们全都忙，店也倒闭了。好难过。人到中年突然失去了和旧时朋友相聚的机会。#南阳市", "extract_text_enabled": 0, "geo_info": { "distance": "" }, "has_music": false, "id": "699ac514000000001a023963", "images_list": [ { "fileid": "1040g00831ssql5qnm85g5p7o7621m63o0hcapb0", "height": 3072, "need_load_original_image": false, "original": "", "trace_id": "1040g00831ssql5qnm85g5p7o7621m63o0hcapb0", "url": "https://sns-na-i2.xhscdn.com/1040g00831ssql5qnm85g5p7o7621m63o0hcapb0?imageView2/2/w/576/format/heif/q/58|imageMogr2/strip&redImage/frame/0/enhance/4&ap=5&sc=SRH_PRV&sign=1a03e8797b04253659c7cfc84958295c&t=6ad8bc4c", "url_size_large": "https://sns-na-i2.xhscdn.com/1040g00831ssql5qnm85g5p7o7621m63o0hcapb0?imageView2/2/w/1440/format/heif/q/45&redImage/frame/0&ap=5&sc=SRH_DTL&sign=1a03e8797b04253659c7cfc84958295c&t=6ad8bc4c", "width": 4096 } ], "interaction_area": { "status": false, "text": "245", "type": 1 }, "last_update_time": 0, "liked": false, "liked_count": 245, "nice_count": 0, "niced": false, "note_attributes": [], "result_from": "", "shared_count": 132, "tag_info": { "title": "", "type": "" }, "timestamp": 1771750676, "title": "天塌了，陪伴了南阳二十年的哥德咖啡倒闭了", "type": "normal", "update_time": 1773364428000, "user": { "followed": false, "images": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo318qfc8vbk66g5p7o7621m63ouvi1mq8?imageView2/2/w/80/format/jpg", "nickname": "霜*", "red_id": "999***86", "red_official_verified": false, "red_official_verify_type": 0, "show_red_official_verify_icon": false, "track_duration": 0, "userid": "64f839840000000006031878" }, "widgets_context": "{\"flags\":{},\"author_id\":\"64f839840000000006031878\",\"author_name\":\"霜恸\"}", "xsec_token": "YBn1AYa_Qg976rX5bKUocOBOVnyGc_b-VozRlTvKiGUo8=" } } ], "query_debug_info": { "is_forbidden": false }, "query_intent": { "goodsIntent": 3, "low_supply_intent": false, "search_ask_intent": true }, "query_type": 0, "request_dqa": 0, "request_dqa_instant": false, "search_dqa_new_page_exp": 1, "search_pull_down_opt_exp": 1, "search_request_id": "1818628fea100600", "service_status": "{\"filter\":\"not_required\",\"note\":\"success\",\"onebox\":\"not_requ…", "show_single_col": false, "strategy_info": { "query_average_impression_count": 19, "query_can_guide_to_feed": true }, "taxonomy1": "5ab094be481d26b8ef9045f1", "video_intent_grade_v3": 1 }, "meta": { "billed": true, "charged_usd": "0.005000", "balance_usd": "9.995000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.xiaohongshu.search", "x-qovia-title-zh": "小红书笔记搜索", "x-qovia-description-zh": "按关键词搜索小红书笔记，每页 20 条。data 是平台返回的搜索结果原始字段：items（每项含 model_type 和 note；note 里有 id、xsec_token、title、desc、type、liked_count、comments_count、collected_count、shared_count、timestamp、images_list、video_info_v2、user 等）及平台的其他字段，不做改名、筛选或换算；非笔记类的结果项（model_type 不是 note）也原样保留，只有笔记按条计费。 可按综合、最新、最多点赞、最多评论或最多收藏排序，按笔记类型和发布时间筛选。用 page 翻页；响应不含 has_more，翻到没有结果（空结果，不计费）为止。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:xiaohongshu", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 5000, "usd_per_call": "0.005000", "usd_per_1k": "5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.xiaohongshu.search/" } }, "/v1/raw/xiaohongshu/note_v4": { "get": { "operationId": "raw_xiaohongshu_note_v4", "summary": "Xiaohongshu (RedNote) note detail V4", "description": "One Xiaohongshu note, read as an image-text note and returned as the platform answers it, in JSON: note_list (note ID, title, text, like / comment / save / share counts, topics, publish time, IP location, images) and user (the author). No video link or duration. Only an answer with data is charged; an empty answer or an error is not.", "tags": [ "Xiaohongshu (RedNote)" ], "parameters": [ { "name": "note_id", "in": "query", "required": true, "description": "Note ID (24 hex characters, the ID in xiaohongshu.com/explore/)", "x-qovia-description-zh": "笔记 ID（24 位十六进制，笔记链接 xiaohongshu.com/explore/ 里的 ID）", "schema": { "type": "string", "pattern": "^[0-9a-f]{24}$", "examples": [ "6a14846d000000000702d0d4" ] }, "example": "6a14846d000000000702d0d4" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "comment_list": [], "model_type": "note", "note_list": [ { "api_upgrade": -1, "ats": [], "biz_map": {}, "co_produce_link": "xhsdiscover://post_new_note?source=%7B%22type%22%3A%22together_post%22%2C%22extraInfo%22%3A%7B%22subType%22%3A%22together_post_halfspace%22%2C%22track_id%22%3A%226a428d8a00000000110176a2%22%7D%7D&page=%7B%22page_type%22%3A%22image_co_produce_album%22%7D", "collected": false, "collected_count": 4668, "comment_prompt_config": { "forbidden_cmt_type": 0, "placeholder_long": "有话要说，快来评论", "placeholder_short": "说点什么..." }, "comments_count": 1127, "content_trans_info": { "strategy": 10 }, "cooperate_binds": [], "countdown": 0, "desc": "筛选标准:\n200大卡内，无植脂末，无果葡糖浆\n\t\n植脂末和果葡糖浆很难代谢，当你摄入相同热量的饮品，但这些就是会让你长内脏脂肪——也就是大家担忧的涨体脂率\n\t\n能喝的:各种美式 果味美式 小黄油美式 生椰美式 奶酪美式\n唯一避雷美式:葡萄冰萃美式（含果葡糖浆 其它是加的nfc果汁）\n\t\n唯二能喝的拿铁:茉莉花香拿铁 燕麦拿铁\n其它的风味拿铁都有添加糖\n\t\n排序:纯美式＞各种果味美式＞茉莉花香拿铁＞燕麦拿铁＞生椰美式≈小黄油美式＞奶酪美式\n\t\n另外小黄油美式总是饱受诟病 被人说天天喝了涨体脂率 其实涨体脂率是摄入了难代谢的添加糖浆 但小黄油美式里的黄油是代谢路径正常的天然脂肪 在控制总热量的前提下可以放心喝\n#瑞幸咖啡[话题]# #小黄油美式[话题]# #低卡饮品[话题]# #瑞幸[话题]# #咖啡[话题]##减脂[话题]#", "enable_brand_lottery": false, "enable_co_produce": true, "enable_fls_bridge_cards": false, "enable_fls_related_cards": false, "feedback_info": { "dislike_status": 0 }, "foot_tags": [], "function_switch": [ { "enable": true, "type": "image_download" }, { "enable": true, "type": "quote_note" } ], "goods_info": {}, "has_co_produce": false, "has_music": false, "has_related_goods": false, "hash_tag": [ { "bizId": "", "current_score": 0, "id": "5be69f4d50fe560001f91567", "link": "xhsdiscover://rn/ads-topic/page?id=5be69f4d47d0df00018b9c4d&page_source=note_feed.click_new_big", "name": "瑞幸咖啡", "record_count": 0, "record_emoji": "", "record_unit": "", "tag_hint": "", "type": "topic" }, { "bizId": "", "current_score": 0, "id": "66ed2c2c0000000003018b7b", "link": "xhsdiscover://rn/sns-discover/topic/normal?id=66ed2c2d1e986500013fefac&page_source=note_feed.click_new_big", "name": "小黄油美式", "record_count": 0, "record_emoji": "", "record_unit": "", "tag_hint": "", "type": "topic" } ], "head_tags": [], "id": "6a428d8a00000000110176a2", "images_list": [ { "fileid": "1040g0083220lo77i746g5pardl325giko8059no", "height": 1600, "index": 0, "latitude": 0, "longitude": 0, "need_load_original_image": true, "origin_img": { "height": 1600, "size": 0, "width": 1200 }, "original": "http://sns-img-qc.xhscdn.com/1040g0083220lo77i746g5pardl325giko8059no?imageView2/2/w/5000/h/5000/format/webp/q/90&ap=1&sc=ORIGINAL&sign=6c2b930f7b177939cf1d2892106a93b7&t=6ae34ae4", "scale_to_large": 4, "text_intention": 0, "trace_id": "1040g0083220lo77i746g5pardl325giko8059no", "url": "http://sns-img-qc.xhscdn.com/1040g0083220lo77i746g5pardl325giko8059no?imageView2/2/w/576/format/webp/q/87%7CimageMogr2/strip&redImage/frame/0&ap=1&sc=PREVIEW&sign=6c2b930f7b177939cf1d2892106a93b7&t=6ae34ae4", "url_multi_level": { "high": "http://sns-img-qc.xhscdn.com/1040g0083220lo77i746g5pardl325giko8059no?imageView2/2/w/576/format/webp/q/75%7CimageMogr2/strip&redImage/frame/0&ap=1&sc=PREVIEW&sign=6c2b930f7b177939cf1d2892106a93b7&t=6ae34ae4", "low": "http://sns-img-qc.xhscdn.com/1040g0083220lo77i746g5pardl325giko8059no?imageView2/2/w/576/format/webp/q/75%7CimageMogr2/strip&redImage/frame/0&ap=1&sc=PREVIEW&sign=6c2b930f7b177939cf1d2892106a93b7&t=6ae34ae4", "medium": "http://sns-img-qc.xhscdn.com/1040g0083220lo77i746g5pardl325giko8059no?imageView2/2/w/576/format/webp/q/75%7CimageMogr2/strip&redImage/frame/0&ap=1&sc=PREVIEW&sign=6c2b930f7b177939cf1d2892106a93b7&t=6ae34ae4" }, "url_size_large": "http://sns-img-qc.xhscdn.com/1040g0083220lo77i746g5pardl325giko8059no?imageView2/2/w/1440/format/webp&ap=1&sc=DETAIL&sign=6c2b930f7b177939cf1d2892106a93b7&t=6ae34ae4", "width": 1200 } ], "in_censor": false, "ip_location": "浙江", "last_update_time": 1782748854, "liked": false, "liked_count": 10807, "liked_users": [], "long_press_share_info": { "block_private_msg": false, "content": "", "function_entries": [ { "type": "image_download" } ], "guide_audited": false, "is_star": false, "show_wechat_tag": false, "title": "" }, "may_have_red_packet": false, "media_save_config": { "disable_save": false, "disable_watermark": false, "disable_weibo_cover": false }, "mini_program_info": { "desc": "筛选标准: 200大卡内，无植脂末，无果葡糖浆 植脂末和果葡糖浆很难代谢，当你摄入相同热量的饮品，但这些就是会让你长内脏", "path": "pages/main/home/index?redirect_path=%2Fpages%2Fmain%2Fnote%2Findex%3Fxsec_source%3Dapp_share%26id%3D6a428d8a00000000110176a2%26type%3Dnormal%26xsec_token%3DCBJXST_kdISsA6o0LLt18NQ2uIVQGkEJmTF701xMhF4Qc%3D", "share_title": "@Sophia 发了一篇笔记，快点来看吧！", "thumb": "http://sns-img-qc.xhscdn.com/1040g0083220lo77i746g5pardl325giko8059no?imageView2/2/w/540/format/jpg/q/75", "title": "@Sophia 发了一篇笔记，快点来看吧！", "user_name": "gh_52be748ce5b7", "webpage_url": "https://www.xiaohongshu.com/discovery/item/6a428d8a00000000110176a2?xsec_source=app_share&xsec_token=CBJXST_kdISsA6o0LLt18NQ2uIVQGkEJmTF701xMhF4Qc=" }, "model_type": "note", "need_next_step": false, "need_product_review": false, "note_text_press_options": [ { "extra": "", "key": "copy" } ], "pre_view_count": -1, "privacy": { "nick_names": "", "show_tips": false, "type": 0 }, "qq_mini_program_info": { "desc": "筛选标准: 200大卡内，无植脂末，无果葡糖浆 植脂末和果葡糖浆很难代谢，当你摄入相同热量的饮品，但这些就是会让你长内脏", "path": "pages/main/note/index?xsec_source=app_share&id=6a428d8a00000000110176a2&type=normal&xsec_token=CBJXST_kdISsA6o0LLt18NQ2uIVQGkEJmTF701xMhF4Qc=", "share_title": "@Sophia 发了一篇超赞的笔记，快点来看！", "thumb": "http://sns-img-qc.xhscdn.com/1040g0083220lo77i746g5pardl325giko8059no?imageView2/2/w/540/format/jpg/q/75", "title": "@Sophia 发了一篇超赞的笔记，快点来看！", "user_name": "gh_66c53d495417", "webpage_url": "https://www.xiaohongshu.com/discovery/item/6a428d8a00000000110176a2?xsec_source=app_share&xsec_token=CBJXST_kdISsA6o0LLt18NQ2uIVQGkEJmTF701xMhF4Qc=" }, "red_envelope_note": false, "seeded": false, "seeded_count": 0, "share_code_flag": 0, "share_info": { "block_private_msg": false, "content": "筛选标准: 200大卡内，无植脂末，无果葡糖浆 植脂末和果葡糖浆很难代谢，当你摄入相同热量的饮品，但这些就是会让你长内脏", "function_entries": [ { "type": "generate_image" }, { "type": "quote_note" } ], "guide_audited": true, "image": "http://sns-img-qc.xhscdn.com/1040g0083220lo77i746g5pardl325giko8059no?imageView2/2/w/360/format/jpg/q/75", "is_star": false, "link": "https://www.xiaohongshu.com/discovery/item/6a428d8a00000000110176a2?app_platform=ios&app_version=9.28&share_from_user_hidden=true&xsec_source=app_share&type=normal&xsec_token=CBJXST_kdISsA6o0LLt18NQ2uIVQGkEJmTF701xMhF4Qc=&author_share=1", "show_wechat_tag": false, "title": "瑞幸其实能喝的并不多", "wechat_share_desc": "@Sophia 的笔记\n1427人分享" }, "shared_count": 1427, "sticky": false, "text_language_code": "zh-Hans", "time": 1782746506, "title": "瑞幸其实能喝的并不多", "topics": [ { "activity_online": false, "business_type": 1, "discuss_num": 0, "id": "5be69f4d50fe560001f91567", "image": "http://ci.xiaohongshu.com/fd75707a-37f8-45ad-b7a7-0feaf36e9cad@r_120w_120h.jpg", "link": "xhsdiscover://rn/ads-topic/page?id=5be69f4d47d0df00018b9c4d&page_source=note_feed.click_new_big", "name": "瑞幸咖啡", "style": 0 } ], "type": "normal", "use_water_color": false, "user": { "followed": false, "fstatus": "none", "id": "655b6d46000000000802c254", "image": "https://sns-avatar-qc-ae.rednotecdn.com/avatar/1040g2jo322ahdedbn06g5pardl325giktld5t4g?imageView2/2/w/80/format/jpg", "level": { "image": "" }, "name": "Sophia", "nickname": "Sophia", "red_id": "1260070946", "red_official_verified": false, "red_official_verify_type": 0, "show_red_official_verify_icon": false, "track_duration": 0, "userid": "655b6d46000000000802c254" }, "view_count": 0, "widgets_context": "{\"flags\":{},\"author_id\":\"655b6d46000000000802c254\",\"author_name\":\"Sophia\",\"q_task_id\":\"\",\"video_rec_bar_info\":\"\"}", "widgets_groups": [ [ "guos_test", "note_next_step" ], [ "guos_test", "vote_stickers" ] ] } ], "track_id": "", "user": { "followed": false, "fstatus": "none", "id": "655b6d46000000000802c254", "image": "https://sns-avatar-qc-ae.rednotecdn.com/avatar/1040g2jo322ahdedbn06g5pardl325giktld5t4g?imageView2/2/w/80/format/jpg", "level": { "image": "" }, "name": "Sophia", "nickname": "Sophia", "red_id": "1260070946", "red_official_verified": false, "red_official_verify_type": 0, "show_red_official_verify_icon": false, "track_duration": 0, "userid": "655b6d46000000000802c254" } }, "meta": { "billed": true, "charged_usd": "0.025360", "balance_usd": "9.974640", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.xiaohongshu.note_v4", "x-qovia-title-zh": "小红书笔记详情 V4", "x-qovia-description-zh": "一篇小红书笔记（按图文笔记取数，原样 JSON 返回）：note_list（笔记 ID、标题、正文、点赞/评论/收藏/分享数、话题、发布时间、IP 属地、图片）和 user（作者）。不返回视频链接和时长。 只对有数据的结果计费，空结果和出错都不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:xiaohongshu", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 25360, "usd_per_call": "0.025360", "usd_per_1k": "25.36" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.xiaohongshu.note_v4/" } }, "/v1/raw/xiaohongshu/comments_v4": { "get": { "operationId": "raw_xiaohongshu_comments_v4", "summary": "Xiaohongshu (RedNote) note comments V4", "description": "First-level comments of a note, returned as the platform answers them, in JSON: comments (text, likes, reply count, time, images, commenter), comment_count, cursor, has_more and more. sort=default (the default) is the default order, latest is newest first. Only the first page is returned and there is no paging parameter, so the cursor / has_more in the answer are informational. Only an answer with data is charged; an empty answer or an error is not.", "tags": [ "Xiaohongshu (RedNote)" ], "parameters": [ { "name": "note_id", "in": "query", "required": true, "description": "Note ID (24 hex characters)", "x-qovia-description-zh": "笔记 ID（24 位十六进制）", "schema": { "type": "string", "pattern": "^[0-9a-f]{24}$", "examples": [ "6a14846d000000000702d0d4" ] }, "example": "6a14846d000000000702d0d4" }, { "name": "sort", "in": "query", "required": false, "description": "Order: default is Xiaohongshu's own (pinned and popular first), latest is newest first", "x-qovia-description-zh": "排序：default 小红书默认顺序（置顶、热门在前），latest 从新到旧", "schema": { "type": "string", "enum": [ "default", "latest" ], "default": "default" } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "comment_count": 1127, "comments": [ { "at_users": [], "score": 10000000, "status": 4, "sub_comments": [ { "id": "6a44aea50000000015011aca", "at_users": [], "time": 1782886054, "show_tags": [], "show_tags_v2": [], "share_strategy": 0, "note_id": "6a428d8a00000000110176a2", "content": "Plq是啥", "liked": false, "friend_liked_msg": "", "translation_strategy": 10, "collected": false, "comment_type": 0, "hidden": false, "status": 0, "user": { "nickname": "JeansQueen", "images": "https://sns-avatar-qc-ae.rednotecdn.com/avatar/1040g2jo31jo5tr1i34dg49q0r784jt4aie9v8b8?imageView2/2/w/120/format/jpg", "red_id": "49392603669", "level": { "image": "" }, "additional_tags": {}, "ai_agent": false, "current_user": "false", "userid": "a6ccbf41167047c48072721a5d391" }, "show_type": "common", "like_count": 90, "score": -90, "target_comment": { "status": 4, "user": { "nickname": "Sophia", "red_id": "1260070946", "ai_agent": false, "userid": "a8566799df62d46dfdd49c994ea8d", "images": "https://sns-avatar-qc-ae.rednotecdn.com/avatar/1040g2jo322ahdedbn06g5pardl325giktld5t4g?imageView2/2/w/120/format/jpg", "level": { "image": "" }, "additional_tags": {}, "current_user": "false" }, "id": "6a447ae20000000009017269" }, "biz_label": { "group_invite": "false", "rich_text": "unknown", "product_review": false }, "downvoted": false } ], "time": 1782872802, "user": { "red_id": "1260070946", "level": { "image": "" }, "current_user": "false", "userid": "a8566799df62d46dfdd49c994ea8d", "nickname": "Sophia", "additional_tags": {}, "ai_agent": false, "images": "https://sns-avatar-qc-ae.rednotecdn.com/avatar/1040g2jo322ahdedbn06g5pardl325giktld5t4g?imageView2/2/w/120/format/jpg" }, "show_tags": [], "sub_comment_cursor": "{\"cursor\":\"6a44aea50000000015011aca\",\"index\":1}", "id": "6a447ae20000000009017269", "note_id": "6a428d8a00000000110176a2", "content": "po主的标准是无植脂末/果葡糖浆，我一周喝两杯，所以对我来说少许添加剂可以接受，不用抛开剂量谈毒性。\n每天一杯的朋友请注意，最健康零添加的是plq提名的纯美式/拿铁/澳瑞白/卡布奇诺\n关注血糖的朋友尽量不要选择果味美式和燕麦奶，升糖快", "liked": false, "downvoted": false, "show_type": "common", "comment_type": 0, "track_id": "interaction-service.local", "show_tags_v2": [ { "style_id": "red", "pos": "cmt_bottom", "type": "user_top", "text": "置顶评论" }, { "type": "is_author", "text": "作者", "style_id": "red", "pos": "post_name" } ], "biz_label": { "product_review": false, "group_invite": "false", "rich_text": "unknown" }, "translation_strategy": 10, "collected": false, "like_count": 699, "hidden": false, "sub_comment_count": 22, "friend_liked_msg": "", "share_strategy": 0 }, { "comment_type": 0, "track_id": "interaction-service.local", "share_strategy": 0, "content": "黑巧美式呢", "hidden": false, "sub_comments": [], "user": { "current_user": "false", "nickname": "不舍🍊", "images": "https://sns-avatar-qc-ae.rednotecdn.com/avatar/61187a2cf6510d7dd88effe7.jpg?imageView2/2/w/120/format/jpg", "userid": "ad5071f9ceeaac01ac1b0d51d925f", "red_id": "605062852", "level": { "image": "" }, "additional_tags": {}, "ai_agent": false }, "show_tags": [], "ip_location": "安徽", "show_type": "common", "collected": false, "id": "6ae00b7100000000130167c6", "note_id": "6a428d8a00000000110176a2", "like_count": 0, "status": 0, "friend_liked_msg": "", "biz_label": { "rich_text": "unknown", "product_review": false, "group_invite": "false" }, "liked": false, "score": 0, "sub_comment_count": 0, "show_tags_v2": [], "translation_strategy": 10, "downvoted": false, "at_users": [], "time": 1793067889 } ], "has_more": true, "all_sort_strategies": [ { "type": "default", "optional_name": "默认", "suffix_name": "" }, { "type": "latest_v2", "optional_name": "最新", "suffix_name": "" } ], "user_id": "655b6d46000000000802c254", "comment_count_l1": 513, "cursor": "{\"contextId\":\"ebf99b7decdd4544bf46e53f06fdd808\",\"cursor\":\"6acd02850000000007034b16\",\"index\":2,\"pageArea\":\"ALL\"}", "page_context": "{\"highlight\":[\"科技黄油糖浆\"],\"exposed_l1_ids\":\"6a447ae20000000009017269,6ae00b7100000000130167c6,6ada8271000000000b01a411,6ad9f367000000001303ec4b,6ad95e0a000000000a01e607,6ad8397a000000000f02d46a,6ad8319700000000020100e2,6ad7a451000000000a01ddd5,6ad6cf700000000002028cfd,6ad62337000000000f0323a1,6ad27cba000000001103a8b0,6ad0805300000000080271b3,6ad06c4f0000000008033de3,6acf0b8b0000000008002cef,6acd02850000000007034b16\"}", "current_sort_strategy": "latest_v2" }, "meta": { "billed": true, "charged_usd": "0.016910", "balance_usd": "9.983090", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.xiaohongshu.comments_v4", "x-qovia-title-zh": "小红书笔记评论 V4", "x-qovia-description-zh": "一篇笔记的一级评论（原样 JSON 返回）：comments（评论内容、点赞数、回复数、时间、图片、评论者）、comment_count、cursor、has_more 等。 sort 为 default（默认）按默认顺序，latest 从新到旧。 只返回第一页，没有翻页参数，返回里的 cursor / has_more 仅供参考。 只对有数据的结果计费，空结果和出错都不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:xiaohongshu", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 16910, "usd_per_call": "0.016910", "usd_per_1k": "16.91" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.xiaohongshu.comments_v4/" } }, "/v1/raw/xiaohongshu/user_v4": { "get": { "operationId": "raw_xiaohongshu_user_v4", "summary": "Xiaohongshu (RedNote) user profile V4", "description": "A Xiaohongshu user's profile as the platform answers it, in JSON: nickname, Xiaohongshu ID, followers, following, likes and saves, verification, IP location, bio, avatar and more. Only an answer with data is charged; an empty answer or an error is not.", "tags": [ "Xiaohongshu (RedNote)" ], "parameters": [ { "name": "user_id", "in": "query", "required": true, "description": "User ID (24 hex characters, the ID in xiaohongshu.com/user/profile/; not the Xiaohongshu ID)", "x-qovia-description-zh": "用户 ID（24 位十六进制，主页链接 xiaohongshu.com/user/profile/ 里的 ID；不是小红书号）", "schema": { "type": "string", "pattern": "^[0-9a-f]{24}$", "examples": [ "60014bac0000000001009be4" ] }, "example": "60014bac0000000001009be4" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "remark_name": "", "nickname": "Sophia", "share_link": "https://www.xiaohongshu.com/user/profile/655b6d46000000000802c254?xsec_token=YBy_7i7DwJ5PNYEcrlutiWJ4p6VoQCNK737BgpCtqfa8E=&xsec_source=app_share", "desc_at_users": [], "seller_info": { "tab_goods_api_version": 1, "tab_code_names": [], "is_tab_goods_first": true }, "images": "https://sns-avatar-qc-ae.rednotecdn.com/avatar/1040g2jo322ahdedbn06g5pardl325giktld5t4g?imageView2/2/w/360/format/webp", "collected": 6720, "fans": 148, "location": "中国 浙江 杭州", "location_jump": true, "collected_notes_num": 0, "blocking": false, "banner_info": { "image": "http://sns-avatar-qc.rednotecdn.com/user_banner/default/h150-b50.png?imageView2/2/w/540/format/jpg&ap=28&sc=USR_BG", "bg_color": "4b7469", "like_status": false }, "desc": "sophia的朋友圈\nstoic | sophia | syphrosyne\n他人的恶意和愤怒是他人的课题，你的平静和进步才是你的战场", "follows": 114, "nboards": 0, "user_role_type": 0, "red_club_info": { "red_club": false, "red_club_level": 0, "red_club_url": "https://www.xiaohongshu.com/store/mc/landing", "redclubscore": 0 }, "tags": [ { "name": "浙江杭州", "tag_type": "location" }, { "name": "浙江大学", "tag_type": "college" } ], "collected_tags_num": 0, "collected_movie_num": 0, "recommend_info": "", "note_num_stat": { "posted": 13, "liked": 21460, "collected": 6720 }, "show_extra_info_button": false, "share_info_v2": { "title": "@Sophia的个人主页", "content": "粉丝: 148\n获赞与收藏: 2.8万" }, "hula_tabs": { "all_show_tab_config": [ { "tab_id": "note", "tab_name": "笔记", "tab_index_weight": 0 } ], "tab_id_selected": "note" }, "ndiscovery": 13, "tab_public": { "collection": false, "collection_note": true, "collection_board": true, "seed": true }, "blocked": false, "identity_deeplink": "xhsdiscover://rn/app-settings/official/certification/details?type=2&user_id=655b6d46000000000802c254&is_mcn=false", "real_name_deep_target": 1, "is_login_user_pro_account": false, "recommend_info_icon": "", "real_name_info": "", "avatar_handle_entry_list": [], "zhong_tong_bar_info": { "conversions": [] }, "red_official_verify_base_info": "", "block_view_from_user": false, "gender": 2, "level": { "image_link": "", "number": 0 }, "tab_visible": { "note": true, "collect": false, "like": false, "seed": true }, "userid": "655b6d46000000000802c254", "default_collection_tab": "note", "red_official_verify_type": 0, "user_desc_info": { "desc": "sophia的朋友圈\nstoic | sophia | syphrosyne\n他人的恶意和愤怒是他人的课题，你的平静和进步才是你的战场", "desc_at_users": [], "desc_with_placeholder": "sophia的朋友圈\nstoic | sophia | syphrosyne\n他人的恶意和愤怒是他人的课题，你的平静和进步才是你的战场", "desc_keywords_switch": true }, "block_view_to_user": false, "fstatus": "none", "collected_poi_num": 0, "red_id": "1260070946", "share_info": { "title": "Sophia", "content": "sophia的朋友圈\nstoic | sophia | syphrosyne\n他人的恶意和愤怒是他人的课题，你的平静和进步才是你的战场" }, "college_info": { "college_name": "浙江大学", "enrollment_year": 2021 }, "is_recommend_level_illegal": false, "interactions": [ { "type": "follows", "name": "关注", "count": 114, "is_private": true, "toast": "该用户已设置关注列表不可见" }, { "type": "fans", "name": "粉丝", "count": 148, "is_private": true, "toast": "该用户已设置粉丝列表不可见" } ], "sec_account_deeplink": "xhsdiscover://rn/accounts/account-detail?targetId=655b6d46000000000802c254&new_page_exp=1&rn_min_version=3.3.6", "result": { "success": true, "code": 0, "message": "success" }, "red_official_verified": false, "red_official_verify_content": "", "ip_location": "浙江", "identity_label_migrated": false, "user_widget_switch": false, "liked": 21460, "mute_view_to_user": false, "imageb": "https://sns-avatar-qc-ae.rednotecdn.com/avatar/1040g2jo322ahdedbn06g5pardl325giktld5t4g?imageView2/2/w/540/format/webp", "collected_brand_num": 0, "collected_book_num": 0, "avatar_like_status": false, "avatar_pendant": { "current_user_pendant": false, "current_user_pet": false }, "collected_product_num": 0, "community_rule_url": "https://www.xiaohongshu.com/user/community-rule" }, "meta": { "billed": true, "charged_usd": "0.016910", "balance_usd": "9.983090", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.xiaohongshu.user_v4", "x-qovia-title-zh": "小红书用户详情 V4", "x-qovia-description-zh": "小红书用户主页（原样 JSON 返回）：昵称、小红书号、粉丝数、关注数、获赞与收藏、认证、IP 属地、简介和头像等。 只对有数据的结果计费，空结果和出错都不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:xiaohongshu", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 16910, "usd_per_call": "0.016910", "usd_per_1k": "16.91" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.xiaohongshu.user_v4/" } }, "/v1/raw/xiaohongshu/user_notes_v3": { "get": { "operationId": "raw_xiaohongshu_user_notes_v3", "summary": "Xiaohongshu (RedNote) user notes V3", "description": "Notes a user posted, returned as the platform answers them, in JSON: notes (title, interaction counts, cover and images), has_more, tags and more. Paging is supported: pass the cursor of the last note in notes back, and has_more tells whether there is more. Only an answer with data is charged; an empty answer or an error is not.", "tags": [ "Xiaohongshu (RedNote)" ], "parameters": [ { "name": "user_id", "in": "query", "required": true, "description": "User ID (24 hex characters)", "x-qovia-description-zh": "用户 ID（24 位十六进制）", "schema": { "type": "string", "pattern": "^[0-9a-f]{24}$", "examples": [ "60014bac0000000001009be4" ] }, "example": "60014bac0000000001009be4" }, { "name": "cursor", "in": "query", "required": false, "description": "The cursor of the last note on the previous page (that note's id), passed back unchanged to get the next page; omit it for the first page", "x-qovia-description-zh": "上一页最后一篇笔记的 cursor（即该笔记 id），原样传回取下一页；第一页不传", "schema": { "type": "string", "pattern": "^[0-9a-f]{24}$" } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "has_more": false, "notes": [ { "advanced_widgets_groups": { "groups": [ { "fetch_types": [ "guos_test", "note_next_step" ], "mode": 1 }, { "fetch_types": [ "guos_test", "vote_stickers" ], "mode": 0 } ] }, "ats": [], "collected_count": 2, "comments_count": 1, "create_time": 1778835624, "cursor": "6a06e0a8000000003502c562", "desc": "1️⃣如果你对股票的下跌感到恐惧，说明你买了你不了解的公司。\n\t\n2️⃣我所有的研究，都是在努力降低自己交易的频次。更多的研究，只为了更少的频次。\n\t\n3️⃣强势文化是自己做自己命运的主人，弱势文化是", "display_title": "投资教会我的事", "guide_context": "{\"show_goods_c2c\":false}", "has_music": false, "id": "6a06e0a8000000003502c562", "images_list": [ { "fileid": "1040g0083206d1fts5g6g5pardl325gikpaqrar8", "height": 1600, "original": "", "trace_id": "1040g0083206d1fts5g6g5pardl325gikpaqrar8", "url": "https://sns-i27-ae.rednotecdn.com/1040g0083206d1fts5g6g5pardl325gikpaqrar8?imageView2/2/w/576/format/webp/q/87%7CimageMogr2/strip&redImage/frame/0&ap=12&sc=USR_PRV&sign=0fd96e85b70215bf866cc95aca585ffb&t=6ae34b07", "url_size_large": "https://sns-i27-ae.rednotecdn.com/1040g0083206d1fts5g6g5pardl325gikpaqrar8?imageView2/2/w/1440/format/webp&ap=12&sc=USR_DTL&sign=0fd96e85b70215bf866cc95aca585ffb&t=6ae34b07", "width": 1200 } ], "infavs": false, "inlikes": false, "is_goods_note": false, "last_update_time": 1793097362, "likes": 8, "nice_count": 0, "niced": false, "price": 0, "recommend": { "desc": "", "icon": "", "target_id": "", "target_name": "", "track_id": "", "type": "" }, "share_count": 0, "sticky": true, "time_desc": "05-15", "title": "投资教会我的事", "type": "normal", "user": { "followed": false, "fstatus": "none", "images": "https://sns-avatar-qc-ae.rednotecdn.com/avatar/1040g2jo322ahdedbn06g5pardl325giktld5t4g?imageView2/2/w/80/format/jpg", "nickname": "Sophia", "red_official_verify_type": 0, "userid": "655b6d46000000000802c254" }, "view_count": 0, "widgets_context": "{\"flags\":{},\"author_id\":\"655b6d46000000000802c254\",\"author_name\":\"Sophia\"}" }, { "advanced_widgets_groups": { "groups": [ { "fetch_types": [ "guos_test", "note_next_step" ], "mode": 1 }, { "fetch_types": [ "guos_test", "vote_stickers" ], "mode": 0 } ] }, "ats": [], "collected_count": 14, "comments_count": 1, "create_time": 1757322466, "cursor": "68be9ce1000000001c0361fa", "desc": "自用 持续更新\n——————\n1.向上不露穷，向下不露富。\n\t\n2.如无必要，勿增实体，进一出一。\n\t\n3.杜绝和低认知者、负能量者、磁场混浊者交流交往交际，杜绝在互联网上无意义争吵，拉黑屏蔽即可，没", "display_title": "ISFP处世原则", "guide_context": "{\"show_goods_c2c\":false}", "has_music": false, "id": "68be9ce1000000001c0361fa", "images_list": [ { "fileid": "1040g00831m5nq4464s6g5pardl325gikbqhfdf0", "height": 1600, "original": "", "trace_id": "1040g00831m5nq4464s6g5pardl325gikbqhfdf0", "url": "https://sns-i27-ae.rednotecdn.com/1040g00831m5nq4464s6g5pardl325gikbqhfdf0?imageView2/2/w/576/format/webp/q/87%7CimageMogr2/strip&redImage/frame/0&ap=12&sc=USR_PRV&sign=4bdce8e6a57165aad1806beb345d690c&t=6ae34b07", "url_size_large": "https://sns-i27-ae.rednotecdn.com/1040g00831m5nq4464s6g5pardl325gikbqhfdf0?imageView2/2/w/1440/format/webp&ap=12&sc=USR_DTL&sign=4bdce8e6a57165aad1806beb345d690c&t=6ae34b07", "width": 1200 } ], "infavs": false, "inlikes": false, "is_goods_note": false, "last_update_time": 1764200306, "likes": 50, "nice_count": 0, "niced": false, "price": 0, "recommend": { "desc": "", "icon": "", "target_id": "", "target_name": "", "track_id": "", "type": "" }, "share_count": 0, "sticky": true, "time_desc": "2025-09-08", "title": "ISFP处世原则", "type": "normal", "user": { "followed": false, "fstatus": "none", "images": "https://sns-avatar-qc-ae.rednotecdn.com/avatar/1040g2jo322ahdedbn06g5pardl325giktld5t4g?imageView2/2/w/80/format/jpg", "nickname": "Sophia", "red_official_verify_type": 0, "userid": "655b6d46000000000802c254" }, "view_count": 0, "widgets_context": "{\"flags\":{},\"author_id\":\"655b6d46000000000802c254\",\"author_name\":\"Sophia\"}" } ], "tags": [] }, "meta": { "billed": true, "charged_usd": "0.025360", "balance_usd": "9.974640", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.xiaohongshu.user_notes_v3", "x-qovia-title-zh": "小红书用户笔记列表 V3", "x-qovia-description-zh": "一个用户发布的笔记（原样 JSON 返回）：notes（标题、点赞等互动数、封面和图片）、has_more、tags 等。 支持翻页：把 notes 里最后一篇笔记的 cursor 传回，has_more 表示后面是否还有。只对有数据的结果计费，空结果和出错都不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:xiaohongshu", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 25360, "usd_per_call": "0.025360", "usd_per_1k": "25.36" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.xiaohongshu.user_notes_v3/" } }, "/v1/raw/xiaohongshu/search_v4": { "get": { "operationId": "raw_xiaohongshu_search_v4", "summary": "Xiaohongshu (RedNote) note search V4", "description": "Search Xiaohongshu notes by keyword, returned as the platform answers, in JSON: items (each with a note card: title, author, interaction counts, cover and images) and more. Only the first page (about 20 notes) is returned and there is no paging parameter. Sort by relevance, newest, most liked, most commented or most saved; filter by note type; the publish-time filter offers all, a day or a week only. Only an answer with data is charged; an empty answer or an error is not.", "tags": [ "Xiaohongshu (RedNote)" ], "parameters": [ { "name": "keyword", "in": "query", "required": true, "description": "Search keyword", "x-qovia-description-zh": "搜索关键词", "schema": { "type": "string", "minLength": 1, "maxLength": 50, "pattern": "\\S", "examples": [ "咖啡" ] }, "example": "咖啡" }, { "name": "sort", "in": "query", "required": false, "description": "Order: general (relevance, the default), latest, most_liked, most_commented or most_saved", "x-qovia-description-zh": "排序：general 综合（默认）、latest 最新、most_liked 最多点赞、most_commented 最多评论、most_saved 最多收藏", "schema": { "type": "string", "enum": [ "general", "latest", "most_liked", "most_commented", "most_saved" ], "default": "general" } }, { "name": "note_type", "in": "query", "required": false, "description": "Note type: all (the default), video or image notes", "x-qovia-description-zh": "笔记类型：all 不限（默认）、video 视频笔记、image 图文笔记", "schema": { "type": "string", "enum": [ "all", "video", "image" ], "default": "all" } }, { "name": "note_time", "in": "query", "required": false, "description": "Published within: all (the default), a day or a week", "x-qovia-description-zh": "发布时间：all 不限（默认）、day 一天内、week 一周内", "schema": { "type": "string", "enum": [ "all", "day", "week" ], "default": "all" } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "ai_mode_enable": false, "can_cut": false, "cur_cut_number": 0, "dqa_authorized_user_by_shared": false, "extra_info": { "atmosphere_v3_enable": "0" }, "is_broad_query": true, "items": [ { "mix_track_id": "NOTE__6a428d8a00000000110176a2__2h36dws7ziokacdf33xuc__咖啡", "model_type": "note", "new_help_style": false, "note": { "abstract_show": "瑞幸其实能喝的并不多 筛选标准:…#瑞幸咖啡 #小黄油美式 #低卡饮品 #瑞幸 #咖啡 #减脂", "advanced_widgets_groups": { "groups": [ { "fetch_types": [ "guos_test", "note_next_step" ], "mode": 1 }, { "fetch_types": [ "guos_test", "vote_stickers" ], "mode": 0 } ] }, "click_score": 0.0008327323012053967, "collected": false, "collected_count": 4668, "comments_count": 1127, "corner_tag_info": [ { "icon": "", "location": -1, "style": 0, "text": "RAyNlYLhJk0ZwcVo/p7eH+3rmKeDSQ/UHW5mMEZZIJof11SsSzbvTAknoRHa13i2Gfy7bIsMmTOQ7/jUmVmNNuxLbEx1KRhHVj", "text_en": "", "type": "ubt_sig_token" }, { "icon": "http://picasso-static.xiaohongshu.com/fe-platform/e9b67af62f67d9d6cfac936f96ad10a85fdb868e.png", "location": 5, "style": 0, "text": "06-30", "text_en": "06-30", "type": "publish_time" } ], "cover_image_index": 0, "debug_info_str": "", "desc": "筛选标准: 200大卡内，无植脂末，无果葡糖浆 植脂末和果葡糖浆很难代谢，当你摄入相同热量的饮品，但这些就是会让你长内脏", "extract_text_enabled": 0, "geo_info": { "distance": "" }, "has_music": false, "id": "6a428d8a00000000110176a2", "images_list": [ { "fileid": "1040g0083220lo77i746g5pardl325giko8059no", "height": 1600, "need_load_original_image": false, "original": "", "trace_id": "1040g0083220lo77i746g5pardl325giko8059no", "url": "https://sns-na-i2.xhscdn.com/1040g0083220lo77i746g5pardl325giko8059no?imageView2/2/w/576/format/webp/q/87%7CimageMogr2/strip&redImage/frame/0&ap=5&sc=SRH_PRV&sign=829ad0b2f87a3746f8e424dfad17910f&t=6ae34abc", "url_size_large": "https://sns-na-i2.xhscdn.com/1040g0083220lo77i746g5pardl325giko8059no?imageView2/2/w/1440/format/webp&ap=5&sc=SRH_DTL&sign=829ad0b2f87a3746f8e424dfad17910f&t=6ae34abc", "width": 1200 } ], "interaction_area": { "status": false, "text": "10807", "type": 1 }, "last_update_time": 1782748854, "liked": false, "liked_count": 10807, "nice_count": 0, "niced": false, "note_attributes": [], "result_from": "", "shared_count": 1427, "tag_info": { "title": "", "type": "" }, "timestamp": 1782746506, "title": "瑞幸其实能喝的并不多", "type": "normal", "update_time": 1793257148000, "user": { "followed": false, "images": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo322ahdedbn06g5pardl325giktld5t4g?imageView2/2/w/80/format/jpg", "nickname": "Sophia", "red_id": "1260070946", "red_official_verified": false, "red_official_verify_type": 0, "show_red_official_verify_icon": false, "track_duration": 0, "userid": "655b6d46000000000802c254" }, "widgets_context": "{\"flags\":{},\"author_id\":\"655b6d46000000000802c254\",\"author_name\":\"Sophia\"}", "xsec_token": "YBxnVl_PvOuRQ9Umg3Q_boI2zfyOSLyilSPnHo16jmlaw=" } }, { "mix_track_id": "NOTE__69f7dc410000000035021f62__2h36dws7ziokacdf33xuc__咖啡", "model_type": "note", "new_help_style": false, "note": { "advanced_widgets_groups": { "groups": [ { "fetch_types": [ "guos_test", "note_next_step" ], "mode": 1 }, { "fetch_types": [ "guos_test", "vote_stickers" ], "mode": 0 } ] }, "click_score": 0.0010656372178345919, "collected": false, "collected_count": 1002, "comments_count": 1652, "corner_tag_info": [ { "icon": "", "location": -1, "style": 0, "text": "RAC3MDicwztm/hlEcs1ut8QMLUXUc/pcG3TYmtUhCcV8AAcwtDyQzHgjcN1KrMcFm6z22PkOHtpWHKlmvXO6dVww2G7mxzMop+", "text_en": "", "type": "ubt_sig_token" }, { "icon": "http://picasso-static.xiaohongshu.com/fe-platform/e9b67af62f67d9d6cfac936f96ad10a85fdb868e.png", "location": 5, "style": 0, "text": "05-07", "text_en": "05-07", "type": "publish_time" } ], "cover_image_index": 0, "debug_info_str": "", "desc": "图一开封的地方，真的字体会比较清爽，假的是比较粗的，下面的8，真的是相对会扁一点，两个在一起对比有很明显的不同 图二很明", "extract_text_enabled": 0, "geo_info": { "distance": "" }, "has_music": false, "id": "69f7dc410000000035021f62", "images_list": [ { "fileid": "notes_pre_post/1040g3k831vnnp4k7hmd04a1oi1mr8elqsn8nfuo", "height": 2560, "need_load_original_image": false, "original": "", "trace_id": "notes_pre_post/1040g3k831vnnp4k7hmd04a1oi1mr8elqsn8nfuo", "url": "https://sns-na-i2.xhscdn.com/notes_pre_post/1040g3k831vnnp4k7hmd04a1oi1mr8elqsn8nfuo?imageView2/2/w/576/format/webp/q/87%7CimageMogr2/strip&redImage/frame/0&ap=5&sc=SRH_PRV&sign=1a17c22daabc3011b767e94a6bd4479e&t=6ae34abc", "url_size_large": "https://sns-na-i2.xhscdn.com/notes_pre_post/1040g3k831vnnp4k7hmd04a1oi1mr8elqsn8nfuo?imageView2/2/w/1440/format/webp&ap=5&sc=SRH_DTL&sign=1a17c22daabc3011b767e94a6bd4479e&t=6ae34abc", "width": 1920 }, { "fileid": "notes_pre_post/1040g3k831vnnp4k7hmcg4a1oi1mr8elqrm2sgeg", "height": 2560, "need_load_original_image": false, "original": "", "trace_id": "notes_pre_post/1040g3k831vnnp4k7hmcg4a1oi1mr8elqrm2sgeg", "url": "", "url_size_large": "https://sns-na-i2.xhscdn.com/notes_pre_post/1040g3k831vnnp4k7hmcg4a1oi1mr8elqrm2sgeg?imageView2/2/w/1440/format/webp&ap=5&sc=SRH_DTL&sign=9d0e5fd0ec565bea14911361dad0b6aa&t=6ae34abc", "width": 1920 } ], "interaction_area": { "status": false, "text": "1256", "type": 1 }, "last_update_time": 1778137469, "liked": false, "liked_count": 1256, "nice_count": 0, "niced": false, "note_attributes": [], "result_from": "", "shared_count": 293, "tag_info": { "title": "", "type": "" }, "timestamp": 1777851457, "title": "真假摩可纳咖啡对比（一）", "type": "normal", "update_time": 1778137512000, "user": { "followed": false, "images": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo31khvup72iu6g4a1oi1mr8elqqcbfmbo?imageView2/2/w/80/format/jpg", "nickname": "Joy", "red_id": "493145396", "red_official_verified": false, "red_official_verify_type": 0, "show_red_official_verify_icon": false, "track_duration": 0, "userid": "5a916db4e8ac2b54e8b53aba" }, "widgets_context": "{\"flags\":{},\"author_id\":\"5a916db4e8ac2b54e8b53aba\",\"author_name\":\"Joy\"}", "xsec_token": "YB84V9ZT2Ueq6cDx4qB3UUnRJv1qHZ9EWiMJ4uy_pMbvQ=" } } ], "query_debug_info": { "is_forbidden": false }, "query_intent": { "goodsIntent": 3, "low_supply_intent": false, "search_ask_intent": false }, "query_type": 0, "request_dqa": 0, "request_dqa_instant": false, "search_dqa_new_page_exp": 0, "search_pull_down_opt_exp": 1, "search_request_id": "1c6c2cd660c6e4fd", "service_status": "{\"filter\":\"not_required\",\"note\":\"success\",\"onebox\":\"not_required\",\"cost\":{\"all\":758,\"zone\":\"rcsh1\"}}", "show_single_col": false, "strategy_info": { "query_average_impression_count": 19, "query_can_guide_to_feed": true }, "taxonomy1": "5ab094be481d26b8ef9045f1", "video_intent_grade_v3": 1 }, "meta": { "billed": true, "charged_usd": "0.025360", "balance_usd": "9.974640", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.xiaohongshu.search_v4", "x-qovia-title-zh": "小红书笔记搜索 V4", "x-qovia-description-zh": "按关键词搜索小红书笔记（原样 JSON 返回）：items（每条含笔记卡片：标题、作者、互动数、封面和图片）等。 只返回第一页（约 20 条），没有翻页参数。 可按综合、最新、最多点赞、最多评论或最多收藏排序，按笔记类型筛选，发布时间只支持不限、一天内、一周内。 只对有数据的结果计费，空结果和出错都不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:xiaohongshu", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 25360, "usd_per_call": "0.025360", "usd_per_1k": "25.36" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.xiaohongshu.search_v4/" } }, "/v1/raw/pgy/note": { "get": { "operationId": "raw_pgy_note", "summary": "Xiaohongshu Pugongying note detail", "description": "Note body, image structure, likes/saves/comments and topics.", "tags": [ "Xiaohongshu Pugongying" ], "parameters": [ { "name": "note_id", "in": "query", "required": true, "description": "Note ID (24 hex characters)", "x-qovia-description-zh": "笔记 ID（24 位十六进制）", "schema": { "type": "string", "pattern": "^[0-9a-f]{24}$", "examples": [ "6abcb896000000001a0338c3" ] }, "example": "6abcb896000000001a0338c3" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "id": "soc_pgy_ef86d33b7c64", "src": "social", "platform": "pgy", "lang": "zh-CN", "text": "早八人通勤咖啡测评｜这三家真的值", "author": { "uid_hash": "b2b37c7a90cf", "user_id": "5bff56cf000000000500814f", "nickname": "咖啡地图", "followers": 56900 }, "metrics": { "likes": 3204, "comments": 517, "saves": 1188, "shares": 96, "impressions": 182040, "reads": 24310 }, "extra": { "note_type": "image", "topic": "#咖啡测评", "source_id": "6abcb896000000001a0338c3", "url": "https://www.xiaohongshu.com/explore/6abcb896000000001a0338c3", "title": "早八人通勤咖啡测评｜这三家真的值", "topics": [ "咖啡测评", "通勤咖啡" ], "published_at": "2026-07-04T08:12:30+08:00", "images": [ "http://ci.xiaohongshu.com/1040g008325nt8kc64a105n2g1j5m6qn4ten67uo?imageView2/2/w/1080/format/jpg" ], "video_dur_s": null, "brand": null, "metrics_available": true }, "prov": { "hash": "0x28f25812c6759f96", "ts": "2026-07-04T09:12:41+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.010000", "balance_usd": "9.990000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.pgy.note", "x-qovia-title-zh": "小红书蒲公英笔记详情", "x-qovia-description-zh": "笔记正文、图片结构、点赞收藏评论数和话题。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:pgy", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 10000, "usd_per_call": "0.010000", "usd_per_1k": "10" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.pgy.note/" } }, "/v1/raw/pgy/featured_comments": { "get": { "operationId": "raw_pgy_featured_comments", "summary": "Xiaohongshu Pugongying featured comments", "description": "Up to 5 featured comments shown on a note page, no pagination; includes commenter nickname and user id, no IP location. A note without comments returns an empty list and is not charged.", "tags": [ "Xiaohongshu Pugongying" ], "parameters": [ { "name": "note_id", "in": "query", "required": true, "description": "Note ID (24 hex characters)", "x-qovia-description-zh": "笔记 ID（24 位十六进制）", "schema": { "type": "string", "pattern": "^[0-9a-f]{24}$", "examples": [ "6abcb896000000001a0338c3" ] }, "example": "6abcb896000000001a0338c3" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "cid": "426385758826386092", "text": "一瓶能用多久呢？", "likes": 12, "reply_count": 2, "created_at": "2026-10-17T23:39:25+08:00", "user": { "uid_hash": "e8ff6e2cf04e", "user_id": "69c7dadc0000000033024f58", "nickname": "你的眼眸" } }, { "cid": "426371270022688812", "text": "味道闻着怎么样", "likes": 3, "reply_count": 0, "created_at": "2026-10-07T23:46:05+08:00", "user": { "uid_hash": "8de9207b2c3f", "user_id": "6a72b44f0000000013003000", "nickname": "元气少女" } } ], "cursor": null, "has_more": false }, "meta": { "billed": true, "charged_usd": "0.005000", "balance_usd": "9.995000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.pgy.featured_comments", "x-qovia-title-zh": "小红书蒲公英笔记精选评论", "x-qovia-description-zh": "笔记详情页展示的精选评论，最多 5 条，不分页；含评论者昵称和用户 ID，不含 IP 属地。没有评论时返回空列表，不收费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:pgy", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 5000, "usd_per_call": "0.005000", "usd_per_1k": "5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.pgy.featured_comments/" } }, "/v1/raw/pgy/creator": { "get": { "operationId": "raw_pgy_creator", "summary": "Xiaohongshu Pugongying creator profile", "description": "Creator profile with followers, likes & saves and note count.", "tags": [ "Xiaohongshu Pugongying" ], "parameters": [ { "name": "user_id", "in": "query", "required": true, "description": "User ID (24 hex characters)", "x-qovia-description-zh": "用户 ID（24 位十六进制）", "schema": { "type": "string", "pattern": "^[0-9a-f]{24}$", "examples": [ "5f4efa82000000000100717e" ] }, "example": "5f4efa82000000000100717e" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "uid_hash": "7be2a1c09d4e", "nickname": "咖啡地图", "followers": 56900, "likes_and_saves": 702311, "notes": 214, "extra": { "source_id": "5f4efa82000000000100717e", "url": "https://www.xiaohongshu.com/user/profile/5f4efa82000000000100717e", "red_id": "coffeemap", "avatar": "https://sns-avatar-qc.xhscdn.com/avatar/63a9c5f0f71eafc781b0debb.jpg?imageView2/2/w/120/format/jpg", "location": "上海 徐汇区", "gender": "女", "personal_tags": [ "咖啡爱好者", "上班族" ], "content_tags": [ { "category": "美食", "tags": [ "咖啡", "探店" ] } ], "feature_tags": [ "测评" ], "business_notes": 18, "read_median": 6305, "engagement_median": 1066 }, "prov": { "hash": "0x8eac9416fb78111e", "ts": "2026-07-04T09:12:41+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.010000", "balance_usd": "9.990000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.pgy.creator", "x-qovia-title-zh": "小红书蒲公英博主资料", "x-qovia-description-zh": "博主资料：粉丝数、获赞与收藏、笔记数。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:pgy", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 10000, "usd_per_call": "0.010000", "usd_per_1k": "10" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.pgy.creator/" } }, "/v1/raw/pgy/note_search": { "get": { "operationId": "raw_pgy_note_search", "summary": "Xiaohongshu Pugongying note search", "description": "Keyword note search over Pugongying's content square (registered creators only), with impressions, reads, engagements, saves, cooperation/ad flags, brand and author followers. Charged per call, up to 60 notes per page; total is capped at 1000.", "tags": [ "Xiaohongshu Pugongying" ], "parameters": [ { "name": "keyword", "in": "query", "required": true, "description": "Search keyword", "x-qovia-description-zh": "搜索关键词", "schema": { "type": "string", "minLength": 1, "maxLength": 50, "examples": [ "咖啡" ] }, "example": "咖啡" }, { "name": "page", "in": "query", "required": false, "description": "Page number, from 1", "x-qovia-description-zh": "页码，从 1 开始", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1 } }, { "name": "page_size", "in": "query", "required": false, "description": "Items per page", "x-qovia-description-zh": "每页条数", "schema": { "type": "integer", "minimum": 1, "maximum": 60, "default": 20 } }, { "name": "sort", "in": "query", "required": false, "description": "Sort (descending): hot overall popularity, impNum impressions, readNum reads, engageNum engagement, fansNum author followers", "x-qovia-description-zh": "排序（降序）：hot 综合热度、impNum 曝光、readNum 阅读、engageNum 互动、fansNum 作者粉丝数", "schema": { "type": "string", "enum": [ "hot", "impNum", "readNum", "engageNum", "fansNum" ], "default": "hot" } }, { "name": "fans_min", "in": "query", "required": false, "description": "Minimum author followers", "x-qovia-description-zh": "作者粉丝数下限", "schema": { "type": "integer", "minimum": 0 } }, { "name": "fans_max", "in": "query", "required": false, "description": "Maximum author followers", "x-qovia-description-zh": "作者粉丝数上限", "schema": { "type": "integer", "minimum": 0 } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "id": "soc_pgy_2d421ed0641f", "note_id": "6ac8bc350000000012037196", "url": "https://www.xiaohongshu.com/explore/6ac8bc350000000012037196", "title": "茶百道的咖啡喝了不烧心。。。", "published_at": "2026-10-09T18:29:50+08:00", "category": "美食", "subcategory": "美食测评", "note_type": "video", "is_cooperation": true, "is_ad": true, "cover": "http://ci.xiaohongshu.com/1040g0083263lnnrg46005q4b9f1q5jbtudr6578?imageView2/2/w/540/format/jpg/q/75", "impressions": 152935, "reads": 13910, "engagements": 1196, "saves": 259, "author": { "uid_hash": "49b06ca04204", "user_id": "688b4bc3000000002802cd7d", "nickname": "杨梅在碗里", "followers": 36800 }, "brand": "茶百道" } ], "total": 1000, "cursor": 2, "has_more": true }, "meta": { "billed": true, "charged_usd": "0.010000", "balance_usd": "9.990000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.pgy.note_search", "x-qovia-title-zh": "小红书蒲公英笔记搜索", "x-qovia-description-zh": "蒲公英内容广场的关键词笔记搜索，只覆盖已入驻蒲公英的博主。每条带曝光、阅读、互动、收藏、是否合作/广告、合作品牌和作者粉丝数。 按次计费，每页最多 60 条；total 最多 1000。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:pgy", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 10000, "usd_per_call": "0.010000", "usd_per_1k": "10" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.pgy.note_search/" } }, "/v1/raw/pgy/kol_overview": { "get": { "operationId": "raw_pgy_kol_overview", "summary": "Xiaohongshu Pugongying creator overview", "description": "Pugongying creator overview: read and interaction medians with \"beats N% of peers\" percentiles, activity, invite response rate, 30-day follower growth, accumulated impressions and reads, and Pugongying's estimated CPM / CPUV / CPE (CNY). *_pct fields are 0-100. Empty results are not charged.", "tags": [ "Xiaohongshu Pugongying" ], "parameters": [ { "name": "user_id", "in": "query", "required": true, "description": "Creator user ID (24 hex characters)", "x-qovia-description-zh": "博主用户 ID（24 位十六进制）", "schema": { "type": "string", "pattern": "^[0-9a-f]{24}$", "examples": [ "5f4efa82000000000100717e" ] }, "example": "5f4efa82000000000100717e" }, { "name": "business", "in": "query", "required": false, "description": "Notes: 0 regular notes, 1 sponsored notes", "x-qovia-description-zh": "笔记范围：0 日常笔记，1 合作笔记", "schema": { "type": "integer", "enum": [ 0, 1 ], "default": 0 } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "user_id": "5f4efa82000000000100717e", "filters": { "business": 0 }, "as_of": "2026-10-19", "notes": 1, "content_mix": [ { "tag": "家居家装", "pct": 100.0 } ], "trade_names": [], "read_median": 63054, "read_median_beyond_pct": 99.3, "interaction_median": 10667, "interaction_beyond_pct": 99.8, "picture_read_beyond_pct": 98.0, "video_read_beyond_pct": 64.9, "picture_read_cost": 0.32, "video_read_cost": 1.55, "fans_30d_growth_pct": 0.7, "fans_30d_growth_beyond_pct": 78.9, "active_days_last_7": 7, "is_active": true, "response_rate_pct": 41.2, "invites": 34, "easy_connect": false, "advantage": "品效型博主", "advantage_hint": "外溢指标处于前20%水位", "picture_cases": 2, "video_cases": 0, "impressions": 244603, "reads": 63054, "engagements": 11627, "estimates": { "picture_cpm": 0, "picture_cpuv": 0, "picture_cpe": 0, "video_cpm": 12.26, "video_cpuv": 0, "video_cpe": 0.13 }, "prov": { "hash": "0xc26246ba63117ade", "ts": "2026-10-20T12:00:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.010000", "balance_usd": "9.990000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.pgy.kol_overview", "x-qovia-title-zh": "小红书蒲公英博主数据概览", "x-qovia-description-zh": "蒲公英达人数据概览：阅读/互动中位数及超过同类博主的百分比、近 7 天活跃、邀约响应率、粉丝 30 天增长、 累计曝光与阅读，以及蒲公英预估的 CPM / CPUV / CPE（元）。*_pct 为 0–100 的百分数。无数据时返回空，不收费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:pgy", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 10000, "usd_per_call": "0.010000", "usd_per_1k": "10" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.pgy.kol_overview/" } }, "/v1/raw/pgy/kol_note_performance": { "get": { "operationId": "raw_pgy_kol_note_performance", "summary": "Xiaohongshu Pugongying creator note performance", "description": "Pugongying note performance for a creator over 30 or 90 days: impression, read, interaction, like, save, comment and share medians, 100+/1000+ like ratios, video completion, traffic-source shares (0-1), long-tail reads and the notes in the window. No notes in the window returns empty, not charged.", "tags": [ "Xiaohongshu Pugongying" ], "parameters": [ { "name": "user_id", "in": "query", "required": true, "description": "Creator user ID (24 hex characters)", "x-qovia-description-zh": "博主用户 ID（24 位十六进制）", "schema": { "type": "string", "pattern": "^[0-9a-f]{24}$", "examples": [ "5f4efa82000000000100717e" ] }, "example": "5f4efa82000000000100717e" }, { "name": "date_type", "in": "query", "required": false, "description": "Period: 1 last 30 days, 2 last 90 days", "x-qovia-description-zh": "时间范围：1 近 30 天，2 近 90 天", "schema": { "type": "integer", "enum": [ 1, 2 ], "default": 1 } }, { "name": "note_type", "in": "query", "required": false, "description": "Note type: 1 image posts, 2 videos, 3 all", "x-qovia-description-zh": "笔记类型：1 图文，2 视频，3 全部", "schema": { "type": "integer", "enum": [ 1, 2, 3 ], "default": 3 } }, { "name": "ad_switch", "in": "query", "required": false, "description": "Traffic: 1 all traffic, 0 organic only", "x-qovia-description-zh": "流量来源：1 全部流量，0 仅自然流量", "schema": { "type": "integer", "enum": [ 0, 1 ], "default": 1 } }, { "name": "business", "in": "query", "required": false, "description": "Notes: 0 regular notes, 1 sponsored notes", "x-qovia-description-zh": "笔记范围：0 日常笔记，1 合作笔记", "schema": { "type": "integer", "enum": [ 0, 1 ], "default": 0 } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "user_id": "5f4efa82000000000100717e", "filters": { "ad_switch": 1, "business": 0, "date_type": 1, "note_type": 3 }, "notes_count": 1, "video_notes_count": 1, "hundred_like_pct": 100.0, "thousand_like_pct": 100.0, "content_mix": [ { "tag": "家居家装", "pct": 100.0 } ], "trade_names": [], "impression_median": 244603, "impression_median_beyond_pct": 99.3, "read_median": 63054, "read_median_beyond_pct": 99.3, "interaction_median": 10667, "interaction_rate_pct": 18.4, "interaction_beyond_pct": 99.8, "like_median": 10007, "save_median": 398, "comment_median": 262, "share_median": 877, "video_full_view_pct": 6.5, "video_full_view_beyond_pct": 61.5, "picture_3s_view_pct": 0.0, "engagements": 11627, "new_followers": 83, "traffic_sources": { "impressions": { "homefeed": 0.944, "search": 0.019, "follow": 0.004, "detail": 0.008, "nearby": 0.0, "other": 0.025 }, "reads": { "homefeed": 0.959, "search": 0.009, "follow": 0.002, "detail": 0.003, "nearby": 0.0, "other": 0.027 } }, "long_term": { "daily": { "period_start": "2026-02-22", "period_end": "2026-04-23", "notes": 4, "recent_reads": 1230, "recent_reads_beyond_pct": 42.2, "long_term_reads": 1287, "long_term_reads_beyond_pct": 82.2, "recent_sources_pct": { "search": 34.5, "explore": 52.2, "profile": 3.4, "follow": 4.6, "other": 5.3 }, "long_term_sources_pct": { "search": 91.3, "explore": 0.1, "profile": 5.1, "follow": 0.7, "other": 2.9 } }, "cooperation": { "period_start": "2026-02-22", "period_end": "2026-04-23", "notes": 0, "recent_reads": null, "recent_reads_beyond_pct": null, "long_term_reads": null, "long_term_reads_beyond_pct": null, "recent_sources_pct": { "search": null, "explore": null, "profile": null, "follow": null, "other": null }, "long_term_sources_pct": { "search": null, "explore": null, "profile": null, "follow": null, "other": null } } }, "notes": [ { "id": "soc_pgy_25e29f4d353a", "note_id": "6abb548b000000001803aa44", "url": "https://www.xiaohongshu.com/explore/6abb548b000000001803aa44", "title": "无限暖暖真人建造？是暖妈亲自设计的家", "published_on": "2026-09-29", "note_type": "video", "cover": "http://ci.xiaohongshu.com/1040g008325mjkbli586g5nqeva108sbu4q7k10g?imageView2/2/w/540/format/jpg/q/75", "impressions": 244603, "reads": 63054, "engagements": 11627, "likes": 10007, "saves": 398 } ], "prov": { "hash": "0xfe111bced02ca10b", "ts": "2026-10-20T12:00:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.010000", "balance_usd": "9.990000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.pgy.kol_note_performance", "x-qovia-title-zh": "小红书蒲公英博主传播表现", "x-qovia-description-zh": "蒲公英达人传播表现：近 30/90 天笔记的曝光、阅读、互动、点赞、收藏、评论、分享中位数，百赞/千赞比例， 视频完播率，曝光与阅读的流量来源占比（share 为 0–1），长期表现，以及期内笔记列表。期内无笔记时返回空，不收费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:pgy", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 10000, "usd_per_call": "0.010000", "usd_per_1k": "10" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.pgy.kol_note_performance/" } }, "/v1/raw/pgy/kol_notes": { "get": { "operationId": "raw_pgy_kol_notes", "summary": "Xiaohongshu Pugongying creator notes", "description": "Pugongying note cases for a creator: notes with reads, likes, saves, video/ad flags and cooperation brand. Up to 100 notes per page, charged per call; no notes returns an empty list, not charged. This endpoint is slow (about 5-10 s).", "tags": [ "Xiaohongshu Pugongying" ], "parameters": [ { "name": "user_id", "in": "query", "required": true, "description": "Creator user ID (24 hex characters)", "x-qovia-description-zh": "博主用户 ID（24 位十六进制）", "schema": { "type": "string", "pattern": "^[0-9a-f]{24}$", "examples": [ "5f4efa82000000000100717e" ] }, "example": "5f4efa82000000000100717e" }, { "name": "page", "in": "query", "required": false, "description": "Page number, 100 notes per page", "x-qovia-description-zh": "页码，每页 100 条", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1 } }, { "name": "order_type", "in": "query", "required": false, "description": "Sort: 1 newest, 2 most read, 3 most engagement", "x-qovia-description-zh": "排序：1 最新发布，2 阅读最多，3 互动最多", "schema": { "type": "integer", "enum": [ 1, 2, 3 ], "default": 1 } }, { "name": "note_type", "in": "query", "required": false, "description": "Note type: 1 image posts, 2 videos, 3 sponsored notes, 4 all", "x-qovia-description-zh": "笔记类型：1 图文，2 视频，3 合作笔记，4 全部", "schema": { "type": "integer", "enum": [ 1, 2, 3, 4 ], "default": 4 } }, { "name": "ad_switch", "in": "query", "required": false, "description": "Traffic: 1 all traffic, 0 organic only", "x-qovia-description-zh": "流量来源：1 全部流量，0 仅自然流量", "schema": { "type": "integer", "enum": [ 0, 1 ], "default": 1 } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "id": "soc_pgy_25e29f4d353a", "note_id": "6abb548b000000001803aa44", "url": "https://www.xiaohongshu.com/explore/6abb548b000000001803aa44", "title": "无限暖暖真人建造？是暖妈亲自设计的家", "published_on": "2026-09-29", "is_video": true, "is_ad": false, "brand": null, "cover": "http://ci.xiaohongshu.com/1040g008325mjkbli586g5nqeva108sbu4q7k10g?imageView2/2/w/540/format/jpg/q/75", "reads": 63054, "likes": 10007, "saves": 398 } ], "total": 12, "cursor": null, "has_more": false }, "meta": { "billed": true, "charged_usd": "0.010000", "balance_usd": "9.990000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.pgy.kol_notes", "x-qovia-title-zh": "小红书蒲公英博主笔记案例", "x-qovia-description-zh": "蒲公英达人笔记案例：博主的笔记列表，带阅读、点赞、收藏、是否视频、是否广告和合作品牌。每页最多 100 条， 按次计费；没有笔记时返回空列表，不收费。这个接口较慢（约 5–10 秒）。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:pgy", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 10000, "usd_per_call": "0.010000", "usd_per_1k": "10" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.pgy.kol_notes/" } }, "/v1/raw/pgy/kol_core_data": { "get": { "operationId": "raw_pgy_kol_core_data", "summary": "Xiaohongshu Pugongying creator core data", "description": "Pugongying core data for a creator over 30 or 90 days: impressions, reads and engagements in total and per day, with CPM, CPV (per read), CPE (per engagement) and CPUV in CNY. Empty results are not charged.", "tags": [ "Xiaohongshu Pugongying" ], "parameters": [ { "name": "user_id", "in": "query", "required": true, "description": "Creator user ID (24 hex characters)", "x-qovia-description-zh": "博主用户 ID（24 位十六进制）", "schema": { "type": "string", "pattern": "^[0-9a-f]{24}$", "examples": [ "5f4efa82000000000100717e" ] }, "example": "5f4efa82000000000100717e" }, { "name": "date_type", "in": "query", "required": false, "description": "Period: 1 last 30 days, 2 last 90 days", "x-qovia-description-zh": "时间范围：1 近 30 天，2 近 90 天", "schema": { "type": "integer", "enum": [ 1, 2 ], "default": 1 } }, { "name": "note_type", "in": "query", "required": false, "description": "Note type: 1 image posts, 2 videos, 3 all", "x-qovia-description-zh": "笔记类型：1 图文，2 视频，3 全部", "schema": { "type": "integer", "enum": [ 1, 2, 3 ], "default": 3 } }, { "name": "ad_switch", "in": "query", "required": false, "description": "Traffic: 1 all traffic, 0 organic only", "x-qovia-description-zh": "流量来源：1 全部流量，0 仅自然流量", "schema": { "type": "integer", "enum": [ 0, 1 ], "default": 1 } }, { "name": "business", "in": "query", "required": false, "description": "Notes: 0 regular notes, 1 sponsored notes", "x-qovia-description-zh": "笔记范围：0 日常笔记，1 合作笔记", "schema": { "type": "integer", "enum": [ 0, 1 ], "default": 0 } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "user_id": "5f4efa82000000000100717e", "filters": { "ad_switch": 1, "business": 0, "date_type": 1, "note_type": 3 }, "as_of": "2026-10-19", "summary": { "impressions": 244603, "reads": 63054, "engagements": 11627, "cpm": 6.13, "cpv": 0.07, "cpe": 0.13, "cpuv": 0 }, "daily": [ { "date": "2026-09-20", "impressions": 47686, "reads": 9883, "engagements": 316, "cpm": 20.97, "cpv": 0, "cpe": 3.16, "cpuv": 0 }, { "date": "2026-09-21", "impressions": 49077, "reads": 10178, "engagements": 321, "cpm": 20.38, "cpv": 0, "cpe": 3.11, "cpuv": 0 } ], "prov": { "hash": "0x419c351cf5248cdc", "ts": "2026-10-20T12:00:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.010000", "balance_usd": "9.990000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.pgy.kol_core_data", "x-qovia-title-zh": "小红书蒲公英博主笔记数据表现", "x-qovia-description-zh": "蒲公英达人笔记数据表现：近 30/90 天的曝光、阅读、互动汇总和逐日数据，以及 CPM、CPV（每次阅读成本）、 CPE（每次互动成本）、CPUV（元）。无数据时返回空，不收费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:pgy", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 10000, "usd_per_call": "0.010000", "usd_per_1k": "10" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.pgy.kol_core_data/" } }, "/v1/raw/pgy/kol_fans_summary": { "get": { "operationId": "raw_pgy_kol_fans_summary", "summary": "Xiaohongshu Pugongying creator fan summary", "description": "Pugongying fan summary for a creator: followers and growth, active / engaged / reading / paying fans with their ratios and \"beats N% of peers\" percentiles (*_pct fields are 0-100). Empty results are not charged.", "tags": [ "Xiaohongshu Pugongying" ], "parameters": [ { "name": "user_id", "in": "query", "required": true, "description": "Creator user ID (24 hex characters)", "x-qovia-description-zh": "博主用户 ID（24 位十六进制）", "schema": { "type": "string", "pattern": "^[0-9a-f]{24}$", "examples": [ "5f4efa82000000000100717e" ] }, "example": "5f4efa82000000000100717e" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "user_id": "5f4efa82000000000100717e", "followers": 13568, "followers_gained": 93, "growth_pct": 0.7, "growth_beyond_pct": 78.9, "active_fans_28d": 7989, "active_fans_pct": 58.9, "active_fans_beyond_pct": 23.1, "engaged_fans_30d": 132, "engaged_fans_pct": 1.0, "engaged_fans_beyond_pct": 75.5, "reading_fans_30d": 410, "reading_fans_pct": 3.0, "reading_fans_beyond_pct": 57.2, "paying_fans_30d": 1347, "paying_fans_pct": 9.9, "prov": { "hash": "0x6533d772bc5369ce", "ts": "2026-10-20T12:00:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.010000", "balance_usd": "9.990000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.pgy.kol_fans_summary", "x-qovia-title-zh": "小红书蒲公英博主粉丝核心数据", "x-qovia-description-zh": "蒲公英达人粉丝核心数据：粉丝数和增量、增长率，活跃粉丝、互动粉丝、阅读粉丝、购买粉丝的数量与占比， 以及超过同类博主的百分比（*_pct 为 0–100）。无数据时返回空，不收费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:pgy", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 10000, "usd_per_call": "0.010000", "usd_per_1k": "10" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.pgy.kol_fans_summary/" } }, "/v1/raw/pgy/kol_fans_profile": { "get": { "operationId": "raw_pgy_kol_fans_profile", "summary": "Xiaohongshu Pugongying creator fan profile", "description": "Pugongying fan profile for a creator: age, gender, interest, province, city and device distributions (share is a 0-1 fraction). Creators without a profile return empty, not charged.", "tags": [ "Xiaohongshu Pugongying" ], "parameters": [ { "name": "user_id", "in": "query", "required": true, "description": "Creator user ID (24 hex characters)", "x-qovia-description-zh": "博主用户 ID（24 位十六进制）", "schema": { "type": "string", "pattern": "^[0-9a-f]{24}$", "examples": [ "5f4efa82000000000100717e" ] }, "example": "5f4efa82000000000100717e" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "user_id": "5f4efa82000000000100717e", "as_of": "2026-10-19", "ages": [ { "group": "18-24", "share": 0.238 }, { "group": "25-34", "share": 0.4 } ], "gender": { "male": 0.578, "female": 0.422 }, "interests": [ { "name": "生活记录", "share": 0.127 } ], "provinces": [ { "name": "广东", "share": 0.13 } ], "cities": [ { "name": "上海", "share": 0.054 } ], "devices": [ { "name": "apple inc.", "label": "苹果", "share": 0.266 } ], "prov": { "hash": "0xa0934a07ad371913", "ts": "2026-10-20T12:00:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.010000", "balance_usd": "9.990000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.pgy.kol_fans_profile", "x-qovia-title-zh": "小红书蒲公英博主粉丝画像", "x-qovia-description-zh": "蒲公英达人粉丝画像：年龄、性别、兴趣、省份、城市、设备分布（share 为 0–1 的占比）。没有画像时返回空，不收费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:pgy", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 10000, "usd_per_call": "0.010000", "usd_per_1k": "10" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.pgy.kol_fans_profile/" } }, "/v1/raw/pgy/kol_fans_trend": { "get": { "operationId": "raw_pgy_kol_fans_trend", "summary": "Xiaohongshu Pugongying creator follower trend", "description": "Pugongying follower trend for a creator: daily follower totals or increments over 30 or 60 days, with the net gain and its ratio (gained_share is 0-1). Empty results are not charged.", "tags": [ "Xiaohongshu Pugongying" ], "parameters": [ { "name": "user_id", "in": "query", "required": true, "description": "Creator user ID (24 hex characters)", "x-qovia-description-zh": "博主用户 ID（24 位十六进制）", "schema": { "type": "string", "pattern": "^[0-9a-f]{24}$", "examples": [ "5f4efa82000000000100717e" ] }, "example": "5f4efa82000000000100717e" }, { "name": "date_type", "in": "query", "required": false, "description": "Period: 1 last 30 days, 2 last 60 days", "x-qovia-description-zh": "时间范围：1 近 30 天，2 近 60 天", "schema": { "type": "integer", "enum": [ 1, 2 ], "default": 1 } }, { "name": "increase_type", "in": "query", "required": false, "description": "Values: 1 total followers, 2 daily change", "x-qovia-description-zh": "数值口径：1 粉丝总量，2 每日增量", "schema": { "type": "integer", "enum": [ 1, 2 ], "default": 1 } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "user_id": "5f4efa82000000000100717e", "filters": { "date_type": 1, "increase_type": 1 }, "gained": 93, "gained_share": 0.0069, "points": [ { "date": "2026-09-20", "value": 13475 }, { "date": "2026-09-21", "value": 13478 } ], "prov": { "hash": "0x0ac87331786ef97c", "ts": "2026-10-20T12:00:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.010000", "balance_usd": "9.990000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.pgy.kol_fans_trend", "x-qovia-title-zh": "小红书蒲公英博主粉丝趋势", "x-qovia-description-zh": "蒲公英达人粉丝趋势：近 30/60 天每日粉丝总量或增量，以及期内净增粉丝和增长比例（gained_share 为 0–1）。无数据时返回空，不收费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:pgy", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 10000, "usd_per_call": "0.010000", "usd_per_1k": "10" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.pgy.kol_fans_trend/" } }, "/v1/raw/pgy/note_search_v2": { "get": { "operationId": "raw_pgy_note_search_v2", "summary": "Xiaohongshu Pugongying note search V2", "description": "Keyword note search over Pugongying's content square, in the platform's own JSON: each entry in noteList holds noteInfo (noteId, title, note type, publish time, likes likeNum, reads readNum, comments cmtNum, saves favNum, ad flag isAdNote, pictures, video and link) and userInfo (creator nickname, userId, followers fansNum, level), plus total and pageInfoDto (pageNum, pageSize, total, totalPage). 10 notes per page; use page to continue. Usually answers in about 5 seconds. No matching notes answers empty. Only an answer with data is charged; an empty answer or an error is not.", "tags": [ "Xiaohongshu Pugongying" ], "parameters": [ { "name": "keyword", "in": "query", "required": true, "description": "Search keyword", "x-qovia-description-zh": "搜索关键词", "schema": { "type": "string", "minLength": 1, "maxLength": 50, "examples": [ "护肤" ] }, "example": "护肤" }, { "name": "page", "in": "query", "required": false, "description": "Page number, 1 for the first page", "x-qovia-description-zh": "页码，第一页为 1", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 1 } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "noteList": [ { "noteInfo": { "noteId": "6ad9d22f000000002b00118b", "title": "我信任的 交心的 交流的护肤好物 来了！", "noteType": 2, "notePublishTime": "2026-10-23 12:07:10", "likeNum": 43952, "readNum": 797406, "cmtNum": 1543, "favNum": 16102, "isAdNote": 1, "noteLink": "https://www.xiaohongshu.com/explore/6ad9d22f000000002b00118b" }, "userInfo": { "nickName": "姜乘澜", "userId": "646b46200000000010027fbe", "fansNum": 4479913, "currentLevel": 2 } } ], "total": 1000, "pageInfoDto": { "pageNum": 1, "pageSize": 10, "total": 1000, "totalPage": 0 } }, "meta": { "billed": true, "charged_usd": "0.025360", "balance_usd": "9.974640", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.pgy.note_search_v2", "x-qovia-title-zh": "小红书蒲公英笔记搜索 V2", "x-qovia-description-zh": "蒲公英内容广场的关键词笔记搜索，按平台原样 JSON 返回：noteList 中每条含 noteInfo（noteId、标题、笔记类型、发布时间、点赞 likeNum、阅读 readNum、评论 cmtNum、收藏 favNum、是否广告 isAdNote、图片、视频和链接）和 userInfo（博主昵称、userId、粉丝数 fansNum、等级），另有 total 和 pageInfoDto（pageNum、pageSize、total、totalPage）。每页 10 条，用 page 翻页。响应时间通常约 5 秒。没有匹配笔记时返回空结果。只对有数据的结果计费，空结果和出错都不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:pgy", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 25360, "usd_per_call": "0.025360", "usd_per_1k": "25.36" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.pgy.note_search_v2/" } }, "/v1/raw/tiktok/video": { "get": { "operationId": "raw_tiktok_video", "summary": "TikTok video detail", "description": "One TikTok post: caption, author, play / like / comment / share / save counts, hashtags (with their IDs), publish time (UTC), duration, cover and link. A post that does not exist or was deleted answers 404 and is not charged.", "tags": [ "TikTok" ], "parameters": [ { "name": "video_id", "in": "query", "required": true, "description": "TikTok post ID (the number in tiktok.com/@user/video/)", "x-qovia-description-zh": "TikTok 作品 ID（作品链接 tiktok.com/@用户名/video/ 里的数字）", "schema": { "type": "string", "pattern": "^[0-9]{15,20}$", "examples": [ "7688834577418194206" ] }, "example": "7688834577418194206" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "id": "soc_tik_a0e58b99a96a", "src": "social", "platform": "tiktok", "lang": "en", "text": "this group chat deserves a soundtrack 🎤 TikTok x #TheVoice, all season long. #TheVoice 3-night premiere continues tonight, Sept. 23 at 8 p.m. EDT on @NBC and next day on @Peacock 🎶 @NBC's The Voice ", "author": { "uid_hash": "bc27041e9163", "followers": 96372896, "nickname": "TikTok", "uid": "107955", "sec_uid": "MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM", "unique_id": "tiktok" }, "metrics": { "likes": 17754, "comments": 1867, "shares": 729, "saves": 1129, "plays": 661019 }, "extra": { "source_id": "7688834577418194206", "published_at": "2026-09-23T20:45:19+00:00", "video_dur_s": 42, "topic": "#thevoice", "topics": [ "thevoice" ], "topic_ids": { "thevoice": "43468" }, "content_type": "video", "cover_url": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oooSzAqDVEOeU6TFEAAHpAEJII00fa5A2jIlCe~tplv-tiktokx-cropcenter-q:300:400:q70.heic?dr=8596&refresh_token=6b7e99b2&x-expires=1792681200&x-signature=cmACeVJq2y7ze6VQmLiCVMz1eFY%3D&t=bacd0480&ps=933b5bde&shp=d05b14bd&shcp=1d1a97fc&idc=useast5&s=AWEME_DETAIL&sc=cover&biz_tag=tt_video", "url": "https://www.tiktok.com/@tiktok/video/7688834577418194206" }, "prov": { "hash": "0x77779098e3ad0e76", "ts": "2026-10-21T23:15:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.tiktok.video", "x-qovia-title-zh": "TikTok 视频详情", "x-qovia-description-zh": "单个 TikTok 作品：文案、作者、播放/点赞/评论/分享/收藏数、话题（含话题 ID）、发布时间（UTC）、时长、封面和链接。 作品不存在或已删除时返回 404，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:tiktok", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.tiktok.video/" } }, "/v1/raw/tiktok/comments": { "get": { "operationId": "raw_tiktok_comments", "summary": "TikTok video comments", "description": "First-level comments of a post, cursor-paginated, up to 50 a page: text, likes, reply count, time (UTC), whether the creator liked it, and the commenter. Pass the previous page's cursor back to continue; stop when has_more is false. Replies come from raw.tiktok.comment_replies. A post without comments, or one that does not exist, answers empty and is not charged.", "tags": [ "TikTok" ], "parameters": [ { "name": "video_id", "in": "query", "required": true, "description": "TikTok post ID", "x-qovia-description-zh": "TikTok 作品 ID", "schema": { "type": "string", "pattern": "^[0-9]{15,20}$", "examples": [ "7688834577418194206" ] }, "example": "7688834577418194206" }, { "name": "cursor", "in": "query", "required": false, "description": "The cursor from the previous page's response", "x-qovia-description-zh": "取上一页响应的 cursor", "schema": { "type": "integer", "minimum": 0, "default": 0 } }, { "name": "count", "in": "query", "required": false, "description": "Items per page", "x-qovia-description-zh": "每页条数", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 20 } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "cid": "7688835994091668276", "text": "[Sticker] Damm they sound like angels", "likes": 669, "reply_count": 8, "created_at": "2026-09-23T20:50:58+00:00", "liked_by_author": true, "images": [], "author": { "uid_hash": "1c77d3208293", "nickname": "B***~", "uid": "7000000000000000001", "sec_uid": "MS4wLjABAAAAexampleTikTokUserSecUid0000000000000001", "unique_id": "example.user.1" } }, { "cid": "7688850784449053453", "text": "Riley Green and his duck noise 😂", "likes": 236, "reply_count": 9, "created_at": "2026-09-23T21:48:44+00:00", "liked_by_author": true, "images": [], "author": { "uid_hash": "8201ad78c9e9", "nickname": "A***o", "uid": "7000000000000000002", "sec_uid": "MS4wLjABAAAAexampleTikTokUserSecUid0000000000000002", "unique_id": "example.user.2" } } ], "cursor": 20, "has_more": true, "total": 1867, "prov": { "hash": "0x1b8d24ed4d820c6f", "ts": "2026-10-21T23:15:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.tiktok.comments", "x-qovia-title-zh": "TikTok 视频评论", "x-qovia-description-zh": "作品的一级评论，按游标翻页，每页最多 50 条：评论内容、点赞数、回复数、时间（UTC）、是否被作者点赞和评论者。 把上一页返回的 cursor 传回即可翻页，has_more 为 false 时停止。回复用 raw.tiktok.comment_replies 获取。没有评论或作品不存在时返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:tiktok", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.tiktok.comments/" } }, "/v1/raw/tiktok/comment_replies": { "get": { "operationId": "raw_tiktok_comment_replies", "summary": "TikTok comment replies", "description": "Replies under one comment, cursor-paginated, up to 50 a page: text, likes, time (UTC), the reply it answers, and the replier. Pass the previous page's cursor back to continue; stop when has_more is false. A comment without replies answers empty and is not charged.", "tags": [ "TikTok" ], "parameters": [ { "name": "video_id", "in": "query", "required": true, "description": "TikTok post ID", "x-qovia-description-zh": "TikTok 作品 ID", "schema": { "type": "string", "pattern": "^[0-9]{15,20}$", "examples": [ "7688834577418194206" ] }, "example": "7688834577418194206" }, { "name": "comment_id", "in": "query", "required": true, "description": "Parent comment cid (from the video comments endpoint)", "x-qovia-description-zh": "父评论 cid（来自作品评论接口）", "schema": { "type": "string", "pattern": "^[0-9]{15,20}$", "examples": [ "7688850784449053453" ] }, "example": "7688850784449053453" }, { "name": "cursor", "in": "query", "required": false, "description": "The cursor from the previous page's response", "x-qovia-description-zh": "取上一页响应的 cursor", "schema": { "type": "integer", "minimum": 0, "default": 0 } }, { "name": "count", "in": "query", "required": false, "description": "Items per page", "x-qovia-description-zh": "每页条数", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 20 } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "cid": "7689194623361434398", "text": "name a better duo 😂", "likes": 38, "reply_count": null, "created_at": "2026-09-24T20:02:46+00:00", "liked_by_author": false, "images": [], "author": { "uid_hash": "bc27041e9163", "nickname": "TikTok", "uid": "107955", "sec_uid": "MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM", "unique_id": "tiktok" }, "parent_cid": "7688850784449053453", "reply_to_cid": null }, { "cid": "7689268967651721992", "text": "why. is just an ok now? [Photo]", "likes": 0, "reply_count": null, "created_at": "2026-09-25T00:54:09+00:00", "liked_by_author": false, "images": [], "author": { "uid_hash": "db5a3d41c0fa", "nickname": "X***✓", "uid": "7000000000000000003", "sec_uid": "MS4wLjABAAAAexampleTikTokUserSecUid0000000000000003", "unique_id": "example.user.3" }, "parent_cid": "7688850784449053453", "reply_to_cid": "7689194623361434398" } ], "cursor": 5, "has_more": true, "total": 9, "prov": { "hash": "0x3213b2049308e5a3", "ts": "2026-10-21T23:15:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.tiktok.comment_replies", "x-qovia-title-zh": "TikTok 评论回复", "x-qovia-description-zh": "某条评论下的回复（楼中楼），按游标翻页，每页最多 50 条：回复内容、点赞数、时间（UTC）、回复对象和回复者。 把上一页返回的 cursor 传回即可翻页，has_more 为 false 时停止。没有回复时返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:tiktok", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.tiktok.comment_replies/" } }, "/v1/raw/tiktok/creator": { "get": { "operationId": "raw_tiktok_creator", "summary": "TikTok creator profile", "description": "Creator profile with followers, likes, post count, following, bio, verification and avatar. Pass either sec_uid or unique_id (the username). An account that does not exist answers 404 or 400 and is not charged. Some parameters depend on each other; see x-qovia-params-schema.", "tags": [ "TikTok" ], "parameters": [ { "name": "sec_uid", "in": "query", "required": false, "description": "The user's sec_uid (starts with MS4wLjABAAAA); pass this or unique_id", "x-qovia-description-zh": "用户 sec_uid（MS4wLjABAAAA 开头）；与 unique_id 二选一", "schema": { "type": "string", "pattern": "^MS4wLjABAAAA[0-9A-Za-z_-]{20,100}$" } }, { "name": "unique_id", "in": "query", "required": false, "description": "The username (from tiktok.com/@, without the @); pass this or sec_uid", "x-qovia-description-zh": "用户名（主页链接 tiktok.com/@<用户名> 里的部分，不带 @）；与 sec_uid 二选一", "schema": { "type": "string", "pattern": "^[A-Za-z0-9_.]{2,30}$", "examples": [ "nike" ] }, "example": "nike" } ], "x-qovia-params-schema": { "type": "object", "additionalProperties": false, "properties": { "sec_uid": { "type": "string", "pattern": "^MS4wLjABAAAA[0-9A-Za-z_-]{20,100}$", "description": "The user's sec_uid (starts with MS4wLjABAAAA); pass this or unique_id", "x-qovia-description-zh": "用户 sec_uid（MS4wLjABAAAA 开头）；与 unique_id 二选一" }, "unique_id": { "type": "string", "pattern": "^[A-Za-z0-9_.]{2,30}$", "description": "The username (from tiktok.com/@, without the @); pass this or sec_uid", "x-qovia-description-zh": "用户名（主页链接 tiktok.com/@<用户名> 里的部分，不带 @）；与 sec_uid 二选一", "examples": [ "nike" ] } }, "oneOf": [ { "required": [ "sec_uid" ] }, { "required": [ "unique_id" ] } ] }, "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "uid_hash": "bc27041e9163", "nickname": "TikTok", "followers": 96372866, "total_likes": 465910260, "posts": 1598, "verified": true, "platform": "tiktok", "uid": "107955", "sec_uid": "MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM", "unique_id": "tiktok", "following": 1, "signature": "Your next discovery is waiting on TikTok.", "verify_reason": "Verified account", "avatar_url": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:1080:1080.webp?dr=9640&refresh_token=4f36520e&x-expires=1792767600&x-signature=s4%2F4qptOFzoXARYNzQD1JyH0SsI%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=2472a6c6&idc=useast5", "url": "https://www.tiktok.com/@tiktok", "prov": { "hash": "0x6c101e1fbe7982ea", "ts": "2026-10-21T23:15:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.tiktok.creator", "x-qovia-title-zh": "TikTok 创作者资料", "x-qovia-description-zh": "创作者主页资料：粉丝、获赞、作品数、关注数、简介、认证信息和头像。传 sec_uid 或 unique_id（用户名）其中一个。 账号不存在时返回 404 或 400，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:tiktok", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.tiktok.creator/" } }, "/v1/raw/tiktok/creator_videos": { "get": { "operationId": "raw_tiktok_creator_videos", "summary": "TikTok creator videos", "description": "Posts a creator published, newest first (or most popular first), about 10 a page, as the same records as video detail (same ids). Pass either sec_uid or unique_id. Pass the previous page's cursor back to continue; stop when has_more is false. A creator without posts answers empty and is not charged. Some parameters depend on each other; see x-qovia-params-schema.", "tags": [ "TikTok" ], "parameters": [ { "name": "sec_uid", "in": "query", "required": false, "description": "The user's sec_uid (starts with MS4wLjABAAAA); pass this or unique_id", "x-qovia-description-zh": "用户 sec_uid（MS4wLjABAAAA 开头）；与 unique_id 二选一", "schema": { "type": "string", "pattern": "^MS4wLjABAAAA[0-9A-Za-z_-]{20,100}$" } }, { "name": "unique_id", "in": "query", "required": false, "description": "The username (without the @); pass this or sec_uid", "x-qovia-description-zh": "用户名（不带 @）；与 sec_uid 二选一", "schema": { "type": "string", "pattern": "^[A-Za-z0-9_.]{2,30}$", "examples": [ "tiktok" ] }, "example": "tiktok" }, { "name": "cursor", "in": "query", "required": false, "description": "The cursor from the previous page's response; 0 for the first page", "x-qovia-description-zh": "取上一页响应的 cursor；第一页为 0", "schema": { "type": "integer", "minimum": 0, "default": 0 } }, { "name": "sort", "in": "query", "required": false, "description": "Order: latest (the default) or popular", "x-qovia-description-zh": "排序：latest 最新（默认）、popular 最热门", "schema": { "type": "string", "enum": [ "latest", "popular" ], "default": "latest" } } ], "x-qovia-params-schema": { "type": "object", "additionalProperties": false, "properties": { "sec_uid": { "type": "string", "pattern": "^MS4wLjABAAAA[0-9A-Za-z_-]{20,100}$", "description": "The user's sec_uid (starts with MS4wLjABAAAA); pass this or unique_id", "x-qovia-description-zh": "用户 sec_uid（MS4wLjABAAAA 开头）；与 unique_id 二选一" }, "unique_id": { "type": "string", "pattern": "^[A-Za-z0-9_.]{2,30}$", "description": "The username (without the @); pass this or sec_uid", "x-qovia-description-zh": "用户名（不带 @）；与 sec_uid 二选一", "examples": [ "tiktok" ] }, "cursor": { "type": "integer", "minimum": 0, "default": 0, "description": "The cursor from the previous page's response; 0 for the first page", "x-qovia-description-zh": "取上一页响应的 cursor；第一页为 0" }, "sort": { "type": "string", "enum": [ "latest", "popular" ], "default": "latest", "description": "Order: latest (the default) or popular", "x-qovia-description-zh": "排序：latest 最新（默认）、popular 最热门" } }, "oneOf": [ { "required": [ "sec_uid" ] }, { "required": [ "unique_id" ] } ] }, "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "id": "soc_tik_1d1dace29c96", "src": "social", "platform": "tiktok", "lang": "en", "text": "The throwback sounds we didn’t know we were missing, brought back to life on the FYF 💖 @Adam Barrera unpacks how nostalgia took over TikTok.", "author": { "uid_hash": "bc27041e9163", "followers": 96383847, "nickname": "TikTok", "uid": "107955", "sec_uid": "MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM", "unique_id": "tiktok" }, "metrics": { "likes": 2160, "comments": 664, "shares": 152, "saves": 160, "plays": 110453 }, "extra": { "source_id": "7698770783367171359", "published_at": "2026-10-20T15:23:03+00:00", "video_dur_s": 106, "topic": null, "topics": [], "topic_ids": {}, "content_type": "video", "cover_url": "https://p16-common-sign.tiktokcdn-eu.com/tos-useast8-p-0068-tx2/oYiO1Aj1aA7yiGqAi938DIhBKXXfIw5ACi9AEB~tplv-tiktokx-cropcenter-q:300:400:q70.heic?dr=9232&refresh_token=e4308f3a&x-expires=1792681200&x-signature=yjGRqzothcZNOi4xf%2F2QzNi%2FUdo%3D&t=bacd0480&ps=933b5bde&shp=d05b14bd&shcp=132edbea&idc=no1a&biz_tag=tt_video&s=PUBLISH&sc=cover", "url": "https://www.tiktok.com/@tiktok/video/7698770783367171359" }, "prov": { "hash": "0xe2c5655a06b2623a", "ts": "2026-10-21T23:15:00+08:00", "source": "live" } }, { "id": "soc_tik_fddf5cf084af", "src": "social", "platform": "tiktok", "lang": "en", "text": "this summer gave us pop songs, glam routines, and a few main-character habits. @McCall Mirabella breaks down this summer's souvenirs 🐬☀️", "author": { "uid_hash": "bc27041e9163", "followers": 96383847, "nickname": "TikTok", "uid": "107955", "sec_uid": "MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM", "unique_id": "tiktok" }, "metrics": { "likes": 13070, "comments": 5347, "shares": 1372, "saves": 1303, "plays": 1410452 }, "extra": { "source_id": "7694797676306615583", "published_at": "2026-10-09T22:25:11+00:00", "video_dur_s": 50, "topic": null, "topics": [], "topic_ids": {}, "content_type": "video", "cover_url": "https://p16-common-sign.tiktokcdn-eu.com/tos-useast8-p-0068-tx2/osDEKIayAATxid4XIifhL1BBXAZ8wiCZcATiAJ~tplv-tiktokx-cropcenter-q:300:400:q70.heic?dr=9232&refresh_token=07634866&x-expires=1792681200&x-signature=N3eW1jFxXijNDzUyLY2HaLYHC48%3D&t=bacd0480&ps=933b5bde&shp=d05b14bd&shcp=132edbea&idc=no1a&biz_tag=tt_video&s=PUBLISH&sc=cover", "url": "https://www.tiktok.com/@tiktok/video/7694797676306615583" }, "prov": { "hash": "0xe4f1a942a3c4df06", "ts": "2026-10-21T23:15:00+08:00", "source": "live" } } ], "cursor": 1788883336438, "has_more": true, "prov": { "hash": "0x011d1392782e7aec", "ts": "2026-10-21T23:15:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.tiktok.creator_videos", "x-qovia-title-zh": "TikTok 创作者作品列表", "x-qovia-description-zh": "一个创作者发布的作品，从新到旧（或按热门），每页约 10 条，记录与视频详情相同（同一 id）。传 sec_uid 或 unique_id 其中一个。 把上一页返回的 cursor 传回即可翻页，has_more 为 false 时停止。没有作品时返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:tiktok", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.tiktok.creator_videos/" } }, "/v1/raw/tiktok/search": { "get": { "operationId": "raw_tiktok_search", "summary": "TikTok video search", "description": "Search TikTok posts by keyword, as the same records as video detail (same ids); sort by relevance or likes, filter by publish time, pick the region. Pass the previous page's cursor back to continue (adjacent pages may repeat a few posts: deduplicate by id); stop when has_more is false. No results answers empty and is not charged.", "tags": [ "TikTok" ], "parameters": [ { "name": "keyword", "in": "query", "required": true, "description": "Search keyword", "x-qovia-description-zh": "搜索关键词", "schema": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "\\S", "examples": [ "nike" ] }, "example": "nike" }, { "name": "cursor", "in": "query", "required": false, "description": "The cursor from the previous page's response", "x-qovia-description-zh": "取上一页响应的 cursor", "schema": { "type": "integer", "minimum": 0, "maximum": 1000, "default": 0 } }, { "name": "count", "in": "query", "required": false, "description": "Items per page", "x-qovia-description-zh": "每页条数", "schema": { "type": "integer", "minimum": 1, "maximum": 30, "default": 20 } }, { "name": "sort", "in": "query", "required": false, "description": "Order: general (relevance, the default) or most_liked", "x-qovia-description-zh": "排序：general 相关度（默认）、most_liked 最多点赞", "schema": { "type": "string", "enum": [ "general", "most_liked" ], "default": "general" } }, { "name": "publish_time", "in": "query", "required": false, "description": "Published within: all (the default), a day, a week, a month, three months or half a year", "x-qovia-description-zh": "发布时间：all 不限（默认）、day 一天内、week 一周内、month 一个月内、quarter 三个月内、half_year 半年内", "schema": { "type": "string", "enum": [ "all", "day", "week", "month", "quarter", "half_year" ], "default": "all" } }, { "name": "region", "in": "query", "required": false, "description": "Region, a two-letter uppercase country code (ISO 3166-1); US by default", "x-qovia-description-zh": "地区，两位大写国家代码（ISO 3166-1），默认 US", "schema": { "type": "string", "pattern": "^[A-Z]{2}$", "default": "US", "examples": [ "US" ] }, "example": "US" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "id": "soc_tik_9e48546cd716", "src": "social", "platform": "tiktok", "lang": "en", "text": "Nike mind 001 🔥🔥🔥 #fyp #sneakers #streetwear #streetwear #nike ", "author": { "uid_hash": "e3ccd58d819c", "followers": 2950, "nickname": "Q***y", "uid": "7000000000000000004", "sec_uid": "MS4wLjABAAAAexampleTikTokUserSecUid0000000000000004", "unique_id": "example.user.4" }, "metrics": { "likes": 19, "comments": 0, "shares": 0, "saves": 0, "plays": 4281 }, "extra": { "source_id": "7699038487848193282", "published_at": "2026-10-21T08:41:33+00:00", "video_dur_s": 11, "topic": "#fyp", "topics": [ "fyp", "sneakers", "streetwear", "nike" ], "topic_ids": { "fyp": "229207", "sneakers": "64092", "streetwear": "315492", "nike": "9789" }, "content_type": "video", "cover_url": "https://p16-common-sign.tiktokcdn-us.com/tos-no1a-p-0037-no/ocAJwFYyq2TsDernRfgBHCEjgkEVFGxQAqAxQ4~tplv-tiktokx-cropcenter:500:800.jpeg?biz_tag=musically_video.video_cover&dr=9638&idc=useast8&ps=13740610&refresh_token=a400b46e&shcp=9b759fb9&shp=c1333099&t=4d5b0474&x-expires=1792616400&x-signature=xphAE2iSQWb3avOQxS%2BXfx0N2ZM%3D", "url": "https://www.tiktok.com/@example.user.4/video/7699038487848193282" }, "prov": { "hash": "0xe14a962a80ca2a5d", "ts": "2026-10-21T23:15:00+08:00", "source": "live" } }, { "id": "soc_tik_56aaf63cda54", "src": "social", "platform": "tiktok", "lang": "pt", "text": "Tênis Nike 😍 #airmax95 #nikesneakers #nikeairmax #sporlife #nike ", "author": { "uid_hash": "b04c374c292e", "followers": 8456, "nickname": "T***🥇", "uid": "7000000000000000005", "sec_uid": "MS4wLjABAAAAexampleTikTokUserSecUid0000000000000005", "unique_id": "example.user.5" }, "metrics": { "likes": 1071, "comments": 6, "shares": 69, "saves": 92, "plays": 9423 }, "extra": { "source_id": "7698432825535663381", "published_at": "2026-10-19T17:31:23+00:00", "video_dur_s": 15, "topic": "#airmax95", "topics": [ "airmax95", "nikesneakers", "nikeairmax", "sporlife", "nike" ], "topic_ids": { "airmax95": "3514896", "nikesneakers": "3746670", "nikeairmax": "702042", "sporlife": "43175617", "nike": "9789" }, "content_type": "video", "cover_url": "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-p-0037/oseWwgJgGJFfUFpEAIefACGOsLPTPrGRQh4GGs~tplv-tiktokx-cropcenter:500:800.jpeg?biz_tag=musically_video.video_cover&dr=9638&idc=useast8&ps=13740610&refresh_token=44c1892b&shcp=9b759fb9&shp=c1333099&t=4d5b0474&x-expires=1792616400&x-signature=TraKW2ttdki9mcEnOXr6Jb6Ki%2Fw%3D", "url": "https://www.tiktok.com/@example.user.5/video/7698432825535663381" }, "prov": { "hash": "0x594f2ae067a753d1", "ts": "2026-10-21T23:15:00+08:00", "source": "live" } } ], "cursor": 20, "has_more": true, "prov": { "hash": "0xa1565bda8147e52a", "ts": "2026-10-21T23:15:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.tiktok.search", "x-qovia-title-zh": "TikTok 视频搜索", "x-qovia-description-zh": "按关键词搜索 TikTok 作品，记录与视频详情相同（同一 id）；可按相关度或点赞数排序，按发布时间筛选，按地区取结果。 把上一页返回的 cursor 传回即可翻页（相邻页可能有少量重复，请按 id 去重），has_more 为 false 时停止。没有结果时返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:tiktok", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.tiktok.search/" } }, "/v1/raw/tiktok/user_search": { "get": { "operationId": "raw_tiktok_user_search", "summary": "TikTok user search", "description": "Keyword search for creators with nickname, username, sec_uid, followers, likes, verification and bio, about 20 a page. Pass the previous page's cursor back to continue; stop when has_more is false. No results answers empty and is not charged.", "tags": [ "TikTok" ], "parameters": [ { "name": "keyword", "in": "query", "required": true, "description": "Search keyword", "x-qovia-description-zh": "搜索关键词", "schema": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "\\S", "examples": [ "nike" ] }, "example": "nike" }, { "name": "cursor", "in": "query", "required": false, "description": "The cursor from the previous page's response", "x-qovia-description-zh": "取上一页响应的 cursor", "schema": { "type": "integer", "minimum": 0, "maximum": 1000, "default": 0 } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "uid_hash": "63801dff9c4f", "nickname": "Nike", "uid": "208464585232822272", "sec_uid": "MS4wLjABAAAA_3ndMt8d_tECTdpKgCxcx238tOnQZX-20wqN01aMui5zQ7hsqSdff-jC5qYC-Cl_", "unique_id": "nike", "followers": 9321274, "total_likes": 50052777, "verified": true, "verify_reason": "verified account", "signature": null, "avatar_url": "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/e0b0ac7b6ad6447a8e923fd1eb162f2c~tplv-tiktokx-cropcenter-q:1080:1080:q70.heic?dr=9608&refresh_token=e2a6f980&x-expires=1792681200&x-signature=dxkuSAAlH2pKfgZh8lZMFRIsq3g%3D&t=223449c4&ps=87d6e48a&shp=30310797&shcp=c1333099&idc=no1a&sc=avatar&s=SEARCH", "url": "https://www.tiktok.com/@nike" }, { "uid_hash": "ff054c516289", "nickname": "Nike Football", "uid": "7481436802697839659", "sec_uid": "MS4wLjABAAAASaJUsOF0LAshl5VRYETtJiROSRolZzdAtYOxG1ldR40x8Qk9pY9zvd3jzQI67kWY", "unique_id": "nikefootball", "followers": 703124, "total_likes": 5809232, "verified": true, "verify_reason": "verified account", "signature": null, "avatar_url": "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/91b628158cd4dd88147039197d1842b5~tplv-tiktokx-cropcenter-q:1080:1080:q70.heic?dr=9608&refresh_token=e8f7a335&x-expires=1792681200&x-signature=ztQtO%2BRjwwF6s9o8UHuLzro4GCs%3D&t=223449c4&ps=87d6e48a&shp=30310797&shcp=c1333099&idc=no1a&sc=avatar&s=SEARCH", "url": "https://www.tiktok.com/@nikefootball" } ], "cursor": 20, "has_more": true, "prov": { "hash": "0x95f0f1f7560bc287", "ts": "2026-10-21T23:15:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.tiktok.user_search", "x-qovia-title-zh": "TikTok 用户搜索", "x-qovia-description-zh": "按关键词搜索创作者：昵称、用户名、sec_uid、粉丝、获赞、认证信息和简介，每页约 20 个。 把上一页返回的 cursor 传回即可翻页，has_more 为 false 时停止。没有结果时返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:tiktok", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.tiktok.user_search/" } }, "/v1/raw/tiktok/hashtag_videos": { "get": { "operationId": "raw_tiktok_hashtag_videos", "summary": "TikTok hashtag videos", "description": "Posts under one hashtag, as the same records as video detail (same ids). Hashtag IDs are in a post record's extra.topic_ids. Pass the previous page's cursor back to continue; stop when has_more is false. A hashtag without posts answers empty and is not charged.", "tags": [ "TikTok" ], "parameters": [ { "name": "hashtag_id", "in": "query", "required": true, "description": "Hashtag ID (a value of a post record's extra.topic_ids)", "x-qovia-description-zh": "话题 ID（作品记录 extra.topic_ids 里的值）", "schema": { "type": "string", "pattern": "^[0-9]{1,20}$", "examples": [ "43468" ] }, "example": "43468" }, { "name": "cursor", "in": "query", "required": false, "description": "The cursor from the previous page's response", "x-qovia-description-zh": "取上一页响应的 cursor", "schema": { "type": "integer", "minimum": 0, "maximum": 1000, "default": 0 } }, { "name": "count", "in": "query", "required": false, "description": "Items per page", "x-qovia-description-zh": "每页条数", "schema": { "type": "integer", "minimum": 1, "maximum": 30, "default": 10 } }, { "name": "region", "in": "query", "required": false, "description": "Region: US, GB, FR, JP, VN or SG; US by default", "x-qovia-description-zh": "地区：US、GB、FR、JP、VN 或 SG，默认 US", "schema": { "type": "string", "enum": [ "US", "GB", "FR", "JP", "VN", "SG" ], "default": "US" } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "id": "soc_tik_60c33be50a32", "src": "social", "platform": "tiktok", "lang": "en", "text": "@ivmbigcountry enchants with his powerful take on \"I Put A Spell On You\" by Screamin' Jay Hawkins. Watch the 3-night premiere of #TheVoice starting tonight 8/7c on NBC and next day on Peacock", "author": { "uid_hash": "c50938dcb35c", "followers": null, "nickname": "NBC's The Voice", "uid": "183519689707278336", "sec_uid": "MS4wLjABAAAA4hV9fMViyhGMNvwuTT5SWFzwkDN1EzOhzO-Wf7q2aGvVKYmCOB5jQLPtjYY2vah5", "unique_id": "nbcthevoice" }, "metrics": { "likes": 1755462, "comments": 10785, "shares": 75309, "saves": 120497, "plays": 13058372 }, "extra": { "source_id": "7688183991920545055", "published_at": "2026-09-22T02:40:41+00:00", "video_dur_s": 92, "topic": "#thevoice", "topics": [ "thevoice" ], "topic_ids": { "thevoice": "43468" }, "content_type": "video", "cover_url": "https://p16-common-sign.tiktokcdn-eu.com/tos-useast8-p-0068-tx2/okEAxVdIJEeARAjjeUIACFEIq6D10YAdyfbnqq~tplv-tiktokx-origin.image?dr=1347&refresh_token=92673447&x-expires=1792681200&x-signature=CadlsdI%2FKuwXYQWUEEn7ASgS1GU%3D&t=bacd0480&ps=933b5bde&shp=d05b14bd&shcp=c0f880ed&idc=no1a&sc=cover&biz_tag=tt_video&s=CHALLENGE_AWEME", "url": "https://www.tiktok.com/@nbcthevoice/video/7688183991920545055" }, "prov": { "hash": "0x14c4b70dfb431d12", "ts": "2026-10-21T23:15:00+08:00", "source": "live" } }, { "id": "soc_tik_9156a5c03078", "src": "social", "platform": "tiktok", "lang": "en", "text": "@lex 💜 leaves the Coaches in awe with her unforgettable performance of \"Die on This Hill\" by Sienna Spiro. Find out which Coach she picks tomorrow night as #TheVoice 3-night premiere continues at 8/7c on NBC and next day on Peacock", "author": { "uid_hash": "c50938dcb35c", "followers": null, "nickname": "NBC's The Voice", "uid": "183519689707278336", "sec_uid": "MS4wLjABAAAA4hV9fMViyhGMNvwuTT5SWFzwkDN1EzOhzO-Wf7q2aGvVKYmCOB5jQLPtjYY2vah5", "unique_id": "nbcthevoice" }, "metrics": { "likes": 674231, "comments": 2327, "shares": 15953, "saves": 32244, "plays": 5879859 }, "extra": { "source_id": "7688529299984387358", "published_at": "2026-09-23T01:00:38+00:00", "video_dur_s": 299, "topic": "#thevoice", "topics": [ "thevoice" ], "topic_ids": { "thevoice": "43468" }, "content_type": "video", "cover_url": "https://p16-common-sign.tiktokcdn-eu.com/tos-useast8-p-0068-tx2/okABAfmhBiC1iABCaziJZpELWBKInsdA5XI1JA~tplv-tiktokx-origin.image?dr=1347&refresh_token=2aa0ce0a&x-expires=1792681200&x-signature=31VnpGIvo9FdVQ%2F0runqpSilcOw%3D&t=bacd0480&ps=933b5bde&shp=d05b14bd&shcp=c0f880ed&idc=no1a&biz_tag=tt_video&s=CHALLENGE_AWEME&sc=cover", "url": "https://www.tiktok.com/@nbcthevoice/video/7688529299984387358" }, "prov": { "hash": "0xa8fed1acb1f4b08a", "ts": "2026-10-21T23:15:00+08:00", "source": "live" } } ], "cursor": 10, "has_more": true, "prov": { "hash": "0xb9c4d4b033e7b73d", "ts": "2026-10-21T23:15:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.tiktok.hashtag_videos", "x-qovia-title-zh": "TikTok 话题作品", "x-qovia-description-zh": "一个话题下的作品，记录与视频详情相同（同一 id）。话题 ID 见作品记录的 extra.topic_ids。 把上一页返回的 cursor 传回即可翻页，has_more 为 false 时停止。没有作品时返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:tiktok", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.tiktok.hashtag_videos/" } }, "/v1/raw/youtube/video": { "get": { "operationId": "raw_youtube_video", "summary": "YouTube video detail", "description": "One YouTube video: title and description, channel (name, @handle, subscribers), like / comment / view counts, hashtags, keywords, category, publish time (UTC), duration, language, thumbnail and link. A video that does not exist answers 404 and is not charged.", "tags": [ "YouTube" ], "parameters": [ { "name": "video_id", "in": "query", "required": true, "description": "YouTube video ID (the 11 characters in youtube.com/watch?v=)", "x-qovia-description-zh": "YouTube 视频 ID（视频链接 youtube.com/watch?v= 里的 11 位字符）", "schema": { "type": "string", "pattern": "^[A-Za-z0-9_-]{11}$", "examples": [ "9bZkp7q19f0" ] }, "example": "9bZkp7q19f0" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "id": "soc_you_a3d5e29f65bc", "src": "social", "platform": "youtube", "lang": "ko", "text": "PSY - GANGNAM STYLE(강남스타일) M/V\nPSY - ‘I LUV IT’ M/V @    • PSY - ‘I LUV IT’ M/V  \nPSY - ‘New Face’ M/V @   • PSY - ‘New Face’ M/V  \n\nPSY - 8TH ALBUM '4X2=8' on iTunes @\nhttps://smarturl.it/PSY_8thAlbum\n\nPSY - GANGNAM STYLE(강남스타일) on iTunes @ http://smarturl.it/PsyGangnam\n\n#PSY #싸이 #GANGNAMSTYLE #강남스타일\n\nMore about PSY@\n   / officialpsy  \n  / officialpsy  \n  / psy_oppa  \n  / 42psy42  \nhttp://iTunes.com/PSY\nhttp://sptfy.com/PSY\nhttp://weibo.com/psyoppa", "author": { "uid_hash": "b222b8024cc0", "followers": 20600000, "nickname": "officialpsy", "uid": "UCrDkAvwZum-UTjHmzDI2iIw", "unique_id": "officialpsy" }, "metrics": { "likes": 32323636, "comments": 5400000, "plays": 6099601169 }, "extra": { "source_id": "9bZkp7q19f0", "title": "PSY - GANGNAM STYLE(강남스타일) M/V", "published_at": "2012-07-15T07:46:32+00:00", "video_dur_s": 252, "topic": "#GANGNAMSTYLE", "topics": [ "GANGNAMSTYLE", "PSY", "싸이", "강남스타일" ], "keywords": [ "PSY", "싸이", "강남스타일", "뮤직비디오", "Music Video", "Gangnam Style", "KOREAN SINGER", "KPOP", "KOERAN WAVE", "PSY 6甲", "6th Studio Album", "싸이6집", "육갑", "Psy Gangnam Style" ], "category": "Music", "content_type": "video", "cover_url": "https://i.ytimg.com/vi/9bZkp7q19f0/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=9bZkp7q19f0" }, "prov": { "hash": "0x2e3ae05063727e69", "ts": "2026-10-22T03:30:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.youtube.video", "x-qovia-title-zh": "YouTube 视频详情", "x-qovia-description-zh": "单个 YouTube 视频：标题和简介、频道（名称、@handle、订阅数）、点赞/评论/播放数、话题标签、关键词、分类、发布时间（UTC）、时长、语言、封面和链接。 视频不存在时返回 404，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:youtube", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.youtube.video/" } }, "/v1/raw/youtube/comments": { "get": { "operationId": "raw_youtube_comments", "summary": "YouTube video comments", "description": "First-level comments of a video, top or newest first, about 20 a page: text, likes, reply count, time (UTC, converted from YouTube's \"3 days ago\" and as precise as the unit it names), whether the creator hearted it, and the commenter. Pass the previous page's cursor back to continue; stop when has_more is false. Replies come from raw.youtube.comment_replies with a comment's reply_cursor. A video without comments, or one that does not exist, answers empty and is not charged.", "tags": [ "YouTube" ], "parameters": [ { "name": "video_id", "in": "query", "required": true, "description": "YouTube video ID", "x-qovia-description-zh": "YouTube 视频 ID", "schema": { "type": "string", "pattern": "^[A-Za-z0-9_-]{11}$", "examples": [ "dQw4w9WgXcQ" ] }, "example": "dQw4w9WgXcQ" }, { "name": "sort", "in": "query", "required": false, "description": "Order: top (the default) or newest", "x-qovia-description-zh": "排序：top 热门（默认）、newest 最新", "schema": { "type": "string", "enum": [ "top", "newest" ], "default": "top" } }, { "name": "cursor", "in": "query", "required": false, "description": "The cursor from the previous page's response; leave it out for the first page", "x-qovia-description-zh": "取上一页响应的 cursor；第一页不传", "schema": { "type": "string", "maxLength": 6000, "pattern": "^[A-Za-z0-9_%=-]+$" } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "cid": "UgzHP6__JvKiK1Cmha14AaABAg", "text": "Click this link https://boot.dev/?promo=LTT and use my code LTT to get 25% off your first payment for boot.dev.", "likes": 46, "reply_count": 4, "created_at": "2026-10-20T00:00:00+00:00", "liked_by_author": false, "author": { "uid_hash": "e91c380c4459", "nickname": "@LinusTechTips", "uid": "UCXuqSBlHAE6Xw-yeJA0Tunw", "unique_id": "LinusTechTips" }, "reply_cursor": "Eg0SC0xHQTRaRnItaGZvGAYygwEaUBIaVWd6SFA2X19KdktpSzFDbWhhMTRBYUFCQWciAggAKhhVQ1h1cVNCbEhBRTZYdy15" }, { "cid": "UgxZuA2rLwz-KGgqs5R4AaABAg", "text": "THIS. This is what I want more of- TECH TIPS. This is a fun, informative video about technology. I would love to see more of these. Video idea- I would love to see an Nvidia App guide now that the Nvidia Control panel is going away. Most existing tutorials simply say \"configure this option this way\" but do not fully explain what the option means. I think LTT could do a good job of this.", "likes": 1600, "reply_count": 15, "created_at": "2026-10-20T00:00:00+00:00", "liked_by_author": true, "author": { "uid_hash": "5f0c2a9e41b7", "nickname": "@example.user.1", "uid": "UCexampleCommenter000001", "unique_id": "example.user.1" }, "reply_cursor": "Eg0SC0xHQTRaRnItaGZvGAYygwEaUBIaVWd4WnVBMnJMd3otS0dncXM1UjRBYUFCQWciAggAKhhVQ1h1cVNCbEhBRTZYdy15" } ], "cursor": "Eg0SC0xHQTRaRnItaGZvGAYyjAMKzwJnZXRfcmFua2VkX3N0cmVhbXMtLUNxY0JDSUFFRlJl", "has_more": true, "prov": { "hash": "0x92bfddd95544b4bf", "ts": "2026-10-22T03:30:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.youtube.comments", "x-qovia-title-zh": "YouTube 视频评论", "x-qovia-description-zh": "视频的一级评论，按热门或最新排序，每页约 20 条：评论内容、点赞数、回复数、时间（UTC，按 YouTube 显示的“3 天前”换算，精确到所示单位）、是否被创作者点心和评论者。 把上一页返回的 cursor 传回即可翻页，has_more 为 false 时停止。回复用 raw.youtube.comment_replies 获取，传评论的 reply_cursor。没有评论或视频不存在时返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:youtube", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.youtube.comments/" } }, "/v1/raw/youtube/comment_replies": { "get": { "operationId": "raw_youtube_comment_replies", "summary": "YouTube comment replies", "description": "Replies under one comment: text, likes, time (UTC, converted from \"3 days ago\"), whether the creator hearted it, the parent comment and the replier. About 10 on the first page, about 50 on later ones. For the first page pass a comment's reply_cursor (from raw.youtube.comments), then the previous page's cursor; stop when has_more is false. A comment without replies answers empty and is not charged.", "tags": [ "YouTube" ], "parameters": [ { "name": "cursor", "in": "query", "required": true, "description": "A comment record's reply_cursor for the first page, then the previous page's cursor", "x-qovia-description-zh": "第一页传评论记录的 reply_cursor，之后传上一页响应的 cursor", "schema": { "type": "string", "maxLength": 6000, "pattern": "^[A-Za-z0-9_%=-]+$", "examples": [ "Eg0SC0xHQTRaRnItaGZvGAYygwEaUBIaVWd4WnVBMnJMd3otS0dncXM1UjRBYUFCQWciAggAKhhVQ1h1cVNCbEhBRTZYdy15ZUpBMFR1bncyC0xHQTRaRnItaGZvQAFICoIBAggBQi9jb21tZW50LXJlcGxpZXMtaXRlbS1VZ3hadUEyckx3ei1LR2dxczVSNEFhQUJBZw%3D%3D" ] }, "example": "Eg0SC0xHQTRaRnItaGZvGAYygwEaUBIaVWd4WnVBMnJMd3otS0dncXM1UjRBYUFCQWciAggAKhhVQ1h1cVNCbEhBRTZYdy15ZUpBMFR1bncyC0xHQTRaRnItaGZvQAFICoIBAggBQi9jb21tZW50LXJlcGxpZXMtaXRlbS1VZ3hadUEyckx3ei1LR2dxczVSNEFhQUJBZw%3D%3D" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "cid": "UgxZuA2rLwz-KGgqs5R4AaABAg.AcBrV04REKSAcBweQijAMF", "text": "I feel like it's more of a \"Techquickie\", though.", "likes": 41, "reply_count": null, "created_at": "2026-10-20T00:00:00+00:00", "liked_by_author": false, "author": { "uid_hash": "9a63d1e07c25", "nickname": "@example.user.2", "uid": "UCexampleCommenter000002", "unique_id": "example.user.2" }, "parent_cid": "UgxZuA2rLwz-KGgqs5R4AaABAg" }, { "cid": "UgxZuA2rLwz-KGgqs5R4AaABAg.AcBrV04REKSAcC06hk8b5K", "text": "they should be the Veritasium of pc gaming, with their usual random crap on the side. write that down LTT and pay me later, lol.", "likes": 12, "reply_count": null, "created_at": "2026-10-20T00:00:00+00:00", "liked_by_author": false, "author": { "uid_hash": "c41e8b2f6d90", "nickname": "@example.user.3", "uid": "UCexampleCommenter000003", "unique_id": "example.user.3" }, "parent_cid": "UgxZuA2rLwz-KGgqs5R4AaABAg" } ], "cursor": "Eg0SC0xHQTRaRnItaGZvGAYy2gEKU2dldF9jb21tZW50X3dpdGhfcmVwbGllc19zdHJlYW0t", "has_more": true, "prov": { "hash": "0x9a77dd85a539a1cc", "ts": "2026-10-22T03:30:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.youtube.comment_replies", "x-qovia-title-zh": "YouTube 评论回复", "x-qovia-description-zh": "某条评论下的回复：回复内容、点赞数、时间（UTC，按“3 天前”换算）、是否被创作者点心、所属评论和回复者。第一页约 10 条，之后每页约 50 条。 第一页传评论记录的 reply_cursor（来自 raw.youtube.comments），之后传上一页返回的 cursor，has_more 为 false 时停止。没有回复时返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:youtube", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.youtube.comment_replies/" } }, "/v1/raw/youtube/channel": { "get": { "operationId": "raw_youtube_channel", "summary": "YouTube channel profile", "description": "Channel profile with name, @handle, subscribers, video count (rounded the way YouTube shows them), description, keywords, avatar, banner and link. A channel that does not exist answers 404 or 400 and is not charged.", "tags": [ "YouTube" ], "parameters": [ { "name": "channel_id", "in": "query", "required": true, "description": "Channel ID (24 characters starting with UC, from youtube.com/channel/; a video record's author.uid)", "x-qovia-description-zh": "频道 ID（UC 开头的 24 位字符，频道链接 youtube.com/channel/ 里的部分，也是视频记录的 author.uid）", "schema": { "type": "string", "pattern": "^UC[A-Za-z0-9_-]{22}$", "examples": [ "UCXuqSBlHAE6Xw-yeJA0Tunw" ] }, "example": "UCXuqSBlHAE6Xw-yeJA0Tunw" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "uid_hash": "e91c380c4459", "nickname": "Linus Tech Tips", "followers": 16900000, "posts": 7900, "platform": "youtube", "uid": "UCXuqSBlHAE6Xw-yeJA0Tunw", "unique_id": "LinusTechTips", "signature": "Linus Tech Tips is a passionate team of \"professionally curious\" experts in consumer technology and video production who aim to educate and entertain.\n\nSponsorship Inquiries: partnerships@linusmediagroup.com", "keywords": [ "Unboxing", "Review", "Computer", "Hardware", "Motherboard", "Intel", "AMD", "NVIDIA", "gaming" ], "avatar_url": "https://yt3.googleusercontent.com/gnvYLhXy8FAlPXZ2RTrkrgj-5kyt0vdE2FUGVOiKGdEZIa-wN5A-7nwZBlWJLzUMmoh1NWAU=s900-c-k-c0x00ffffff-no-rj", "banner_url": "https://yt3.googleusercontent.com/U_7GWetO6k4sq3pAkbFEIIWzZLKcIJlGJqNz6NQAhgqF6DVD5pllwWF6trSUWEIRn4MkhNlhy9Y=w2560-fcrop64=1,00005a57ffffa5a8-k-c0xffffffff-no-nd-rj", "url": "https://www.youtube.com/channel/UCXuqSBlHAE6Xw-yeJA0Tunw", "prov": { "hash": "0x7432cf3d8b073d37", "ts": "2026-10-22T03:30:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.youtube.channel", "x-qovia-title-zh": "YouTube 频道资料", "x-qovia-description-zh": "频道资料：名称、@handle、订阅数、视频数（YouTube 显示的约数）、简介、关键词、头像、横幅和链接。频道不存在时返回 404 或 400，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:youtube", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.youtube.channel/" } }, "/v1/raw/youtube/channel_videos": { "get": { "operationId": "raw_youtube_channel_videos", "summary": "YouTube channel videos", "description": "Videos a channel published, newest first, about 30 a page, as the same records as video detail (same ids): title, views (rounded), duration, publish time (UTC, converted from \"3 days ago\"), thumbnail and link. Pass the previous page's cursor back to continue; stop when has_more is false. A channel without videos, or one that does not exist, answers empty and is not charged.", "tags": [ "YouTube" ], "parameters": [ { "name": "channel_id", "in": "query", "required": true, "description": "Channel ID (24 characters starting with UC)", "x-qovia-description-zh": "频道 ID（UC 开头的 24 位字符）", "schema": { "type": "string", "pattern": "^UC[A-Za-z0-9_-]{22}$", "examples": [ "UCuAXFkgsw1L7xaCfnd5JJOw" ] }, "example": "UCuAXFkgsw1L7xaCfnd5JJOw" }, { "name": "cursor", "in": "query", "required": false, "description": "The cursor from the previous page's response; leave it out for the first page", "x-qovia-description-zh": "取上一页响应的 cursor；第一页不传", "schema": { "type": "string", "maxLength": 6000, "pattern": "^[A-Za-z0-9_%=-]+$" } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "id": "soc_you_5dfd188c053b", "src": "social", "platform": "youtube", "lang": null, "text": "Rick Astley - Angels On My Side (Live at The O2, London, April 2026)", "author": { "uid_hash": "7906a4aba221", "followers": null, "nickname": "Rick Astley", "uid": "UCuAXFkgsw1L7xaCfnd5JJOw", "unique_id": "RickAstleyYT" }, "metrics": { "plays": 109000 }, "extra": { "source_id": "PXC_PYeB6F8", "title": "Rick Astley - Angels On My Side (Live at The O2, London, April 2026)", "published_at": "2026-07-23T00:00:00+00:00", "video_dur_s": 231, "content_type": "video", "cover_url": "https://i.ytimg.com/vi/PXC_PYeB6F8/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLDjichxht-_GtPETZ7g8ZB6-E32BQ", "url": "https://www.youtube.com/watch?v=PXC_PYeB6F8" }, "prov": { "hash": "0x18f5cb66ca1f56d7", "ts": "2026-10-22T03:30:00+08:00", "source": "live" } }, { "id": "soc_you_8efd104a1f48", "src": "social", "platform": "youtube", "lang": null, "text": "Rick Astley - Dance (Live at The O2, London, April 2026)", "author": { "uid_hash": "7906a4aba221", "followers": null, "nickname": "Rick Astley", "uid": "UCuAXFkgsw1L7xaCfnd5JJOw", "unique_id": "RickAstleyYT" }, "metrics": { "plays": 62000 }, "extra": { "source_id": "LaOUkDBDjW8", "title": "Rick Astley - Dance (Live at The O2, London, April 2026)", "published_at": "2026-07-23T00:00:00+00:00", "video_dur_s": 234, "content_type": "video", "cover_url": "https://i.ytimg.com/vi/LaOUkDBDjW8/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLB22UoKUjTJ3Jjci9MCfj8vBunIlg", "url": "https://www.youtube.com/watch?v=LaOUkDBDjW8" }, "prov": { "hash": "0xff7e924bd77be796", "ts": "2026-10-22T03:30:00+08:00", "source": "live" } } ], "cursor": "4qmFsgLZCRIYVUN1QVhGa2dzdzFMN3hhQ2ZuZDVKSk93GrwJOGdhRUJ4cUJCM3ItQmpyN0Jn", "has_more": true, "prov": { "hash": "0x2268bfb6e71c9943", "ts": "2026-10-22T03:30:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.youtube.channel_videos", "x-qovia-title-zh": "YouTube 频道视频列表", "x-qovia-description-zh": "一个频道发布的视频，从新到旧，每页约 30 条，记录与视频详情相同（同一 id）：标题、播放数（约数）、时长、发布时间（UTC，按“3 天前”换算）、封面和链接。 把上一页返回的 cursor 传回即可翻页，has_more 为 false 时停止。没有视频或频道不存在时返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:youtube", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.youtube.channel_videos/" } }, "/v1/raw/youtube/search": { "get": { "operationId": "raw_youtube_search", "summary": "YouTube video search", "description": "Search YouTube videos by keyword, about 20 a page, as the same records as video detail (same ids): title, description snippet, channel, views, duration, publish time (UTC, converted from \"3 days ago\"), thumbnail and link. Filter by upload date: the last hour, today, this week, this month (the default) or this year. Pass the previous page's cursor back to continue; stop when has_more is false. No results answers empty and is not charged.", "tags": [ "YouTube" ], "parameters": [ { "name": "keyword", "in": "query", "required": true, "description": "Search keyword", "x-qovia-description-zh": "搜索关键词", "schema": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "\\S", "examples": [ "nike" ] }, "example": "nike" }, { "name": "upload_date", "in": "query", "required": false, "description": "Uploaded within: hour, today, week, month (the default) or year", "x-qovia-description-zh": "上传时间：hour 一小时内、today 今天、week 本周、month 本月（默认）、year 今年", "schema": { "type": "string", "enum": [ "hour", "today", "week", "month", "year" ], "default": "month" } }, { "name": "cursor", "in": "query", "required": false, "description": "The cursor from the previous page's response; leave it out for the first page", "x-qovia-description-zh": "取上一页响应的 cursor；第一页不传", "schema": { "type": "string", "maxLength": 6000, "pattern": "^[A-Za-z0-9_%=-]+$" } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "id": "soc_you_7c265a093c9a", "src": "social", "platform": "youtube", "lang": null, "text": "Nike’s Worsening Slump Forces CEO to Rethink Turnaround\nNike Inc. is cutting jobs and embarking on a sweeping overhaul of the business as results deteriorate and test Wall Street's ...", "author": { "uid_hash": "6586b6e1f98e", "followers": null, "nickname": "Bloomberg Television", "uid": "UCIALMKvObZNtJ6AmdCLP7Lg", "unique_id": null }, "metrics": { "plays": 89001 }, "extra": { "source_id": "RTZP4M8gN0U", "title": "Nike’s Worsening Slump Forces CEO to Rethink Turnaround", "published_at": "2026-10-07T00:00:00+00:00", "video_dur_s": 358, "content_type": "video", "cover_url": "https://i.ytimg.com/vi/RTZP4M8gN0U/hq720.jpg?sqp=-oaymwEgCNAFEJQDSFXyq4qpAxIIARUAAIhCGAFwAcABBrgC9xg=&rs=AOn4CLAq3Ec2ul1G-dVdPJwIKBkFIMQrDQ", "url": "https://www.youtube.com/watch?v=RTZP4M8gN0U" }, "prov": { "hash": "0xb3d4cc9aa6b75e13", "ts": "2026-10-22T03:30:00+08:00", "source": "live" } }, { "id": "soc_you_8ec9fc0734c3", "src": "social", "platform": "youtube", "lang": null, "text": "Rapid Recap: Nike's stock has struggled as it faces stiff competition - here’s what experts say\nCNBC's Jim Cramer, BTIG's Bob Drbul, Evercore ISI's Michael Binetti, and Permanent Portfolio's Michael Cuggino weigh in on ...", "author": { "uid_hash": "d567d3852b43", "followers": null, "nickname": "CNBC Television", "uid": "UCrp_UI8XtuYfpiqluWLD7Lw", "unique_id": null }, "metrics": { "plays": 55577 }, "extra": { "source_id": "tjeur2Hdh8w", "title": "Rapid Recap: Nike's stock has struggled as it faces stiff competition - here’s what experts say", "published_at": "2026-10-07T00:00:00+00:00", "video_dur_s": 167, "content_type": "video", "cover_url": "https://i.ytimg.com/vi/tjeur2Hdh8w/hq720.jpg?sqp=-oaymwEgCNAFEJQDSFXyq4qpAxIIARUAAIhCGAFwAcABBrgC9xg=&rs=AOn4CLBDw_TnBwtbdGDgLWisUxHgCMAa4g", "url": "https://www.youtube.com/watch?v=tjeur2Hdh8w" }, "prov": { "hash": "0x97a713ff74381ed4", "ts": "2026-10-22T03:30:00+08:00", "source": "live" } } ], "cursor": "EpEFEgRuaWtlGowDRWdRSUJCQUJTQlNDQVF0SFYxOWpSMTg0UXpkd1VZSUJDMmxxUzBNeE4w", "has_more": true, "prov": { "hash": "0x5bee0e0b8c810cc0", "ts": "2026-10-22T03:30:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.youtube.search", "x-qovia-title-zh": "YouTube 视频搜索", "x-qovia-description-zh": "按关键词搜索 YouTube 视频，每页约 20 条，记录与视频详情相同（同一 id）：标题、简介摘要、频道、播放数、时长、发布时间（UTC，按“3 天前”换算）、封面和链接。 按上传时间筛选：一小时内、今天、本周、本月（默认）或今年。把上一页返回的 cursor 传回即可翻页，has_more 为 false 时停止。没有结果时返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:youtube", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.youtube.search/" } }, "/v1/raw/instagram/post": { "get": { "operationId": "raw_instagram_post", "summary": "Instagram post detail", "description": "One Instagram post (a picture, a video or Reel, or a carousel): caption, author, like and comment counts, plays and shares (videos), hashtags, the picture of each carousel slide, cover, video duration, place, publish time (UTC) and link; a like count the author hid is null. Pass the post's link or its shortcode. A post that does not exist or was deleted answers 404 and is not charged.", "tags": [ "Instagram" ], "parameters": [ { "name": "post", "in": "query", "required": true, "description": "The post's link (instagram.com/p//, /reel// or /tv//), or the shortcode in it", "x-qovia-description-zh": "帖子链接（instagram.com/p//、/reel// 或 /tv//），或链接里的 shortcode", "schema": { "type": "string", "maxLength": 400, "pattern": "^(?:(?=[0-9]*[A-Za-z_-])[A-Za-z0-9_-]{5,40}|https?://(?:www\\.|m\\.)?instagram\\.com/(?:[A-Za-z0-9._]{1,30}/)?(?:p|reels?|tv)/[A-Za-z0-9_-]{5,40}/?(?:\\?[A-Za-z0-9=&%._-]{0,300})?)$", "examples": [ "DewxhTugF2T" ] }, "example": "DewxhTugF2T" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "id": "soc_ins_db6dd17747d8", "src": "social", "platform": "instagram", "lang": null, "text": "new NBA season prep with @jordanclarksons and @cbrickley603 🏀\n\nthe @nyknicks shooting guard joins the legendary basketball trainer in the gym for a custom workout.", "author": { "uid_hash": "1c8ec1290d27", "followers": null, "nickname": "Instagram", "uid": "25025320", "username": "instagram" }, "metrics": { "likes": 142304, "comments": 12254, "shares": 2075, "plays": 53697159 }, "extra": { "source_id": "4011477195854994819", "shortcode": "DeroUGDhF2D", "published_at": "2026-10-19T16:01:46+00:00", "content_type": "video", "topic": null, "topics": [], "images": [], "cover_url": "https://scontent-cdg4-1.cdninstagram.com/v/t51.82787-15/857156235_18805668469001321_8991881220425152601_n.jpg?stp=dst-jpg_e15_p480x480_tt6&_nc_cat=1&ig_cache_key=NDAxMTQ3NzE5NTg1NDk5NDgxOTE4ODA1NjY4NDY2MDAxMzIx.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLnhwaWRzLjEyMTcuc2RyLnZpZGVvX3VzZXJfdXBsb2FkZWRfdGh1bWJuYWlsLkMzIn0%3D&_nc_ohc=0xrVPmHGbkEQ7kNvwGYYd9D&_nc_oc=AdrvU2a-Q5ISwZghvhBMvBf41-l2slcJgINakbXSSH8TOaVcdHPA0Gyux1jAIf2tq-M&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-cdg4-1.cdninstagram.com&_nc_gid=1TOIYyDhxMZsJhUCXfrKBA&_nc_ss=7a3ba&oh=00_AQMOd4RBrA57M035Ccz9M0yFUOsCbkVc4h-3DEPcT0E4EA&oe=6ADEF9D7", "video_dur_s": 87, "location": "New York, N.Y.", "url": "https://www.instagram.com/p/DeroUGDhF2D/" }, "prov": { "hash": "0xa3dcec5e218eb08e", "ts": "2026-10-22T03:30:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.instagram.post", "x-qovia-title-zh": "Instagram 帖子详情", "x-qovia-description-zh": "单条 Instagram 帖子（图片、视频/Reels 或多图轮播）：文案、作者、点赞数、评论数、视频播放量和分享数（视频）、话题、轮播中每一页的图片、封面、视频时长、地点、发布时间（UTC）和链接；作者隐藏的点赞数为 null。 传帖子链接或其中的 shortcode 均可。帖子不存在或已删除时返回 404，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:instagram", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.instagram.post/" } }, "/v1/raw/instagram/comments": { "get": { "operationId": "raw_instagram_comments", "summary": "Instagram post comments", "description": "First-level comments of a post (in Instagram's ranked order), cursor-paginated, about 15 a page: text, likes, reply count, time (UTC), whether the author liked it, and the commenter. Pass the previous page's cursor back unchanged to continue; stop when has_more is false. Replies come from raw.instagram.comment_replies. A post without comments, or one that does not exist, answers empty and is not charged.", "tags": [ "Instagram" ], "parameters": [ { "name": "post", "in": "query", "required": true, "description": "The post's link or shortcode (a post record's extra.shortcode)", "x-qovia-description-zh": "帖子链接或 shortcode（见帖子记录的 extra.shortcode）", "schema": { "type": "string", "maxLength": 400, "pattern": "^(?:(?=[0-9]*[A-Za-z_-])[A-Za-z0-9_-]{5,40}|https?://(?:www\\.|m\\.)?instagram\\.com/(?:[A-Za-z0-9._]{1,30}/)?(?:p|reels?|tv)/[A-Za-z0-9_-]{5,40}/?(?:\\?[A-Za-z0-9=&%._-]{0,300})?)$", "examples": [ "DewxhTugF2T" ] }, "example": "DewxhTugF2T" }, { "name": "cursor", "in": "query", "required": false, "description": "The cursor from the previous page's response, unchanged; leave it out for the first page", "x-qovia-description-zh": "取上一页响应的 cursor，原样传回；第一页不传", "schema": { "type": "string", "maxLength": 4000, "pattern": "^[A-Za-z0-9_=+/-]+$" } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "cid": "18360615367247033", "text": "Big time 📈", "likes": 7, "reply_count": 1, "created_at": "2026-10-21T17:12:41+00:00", "liked_by_author": false, "author": { "uid_hash": "ad0a04787983", "nickname": "Pinkbike", "uid": "39419021", "username": "pinkbike" } }, { "cid": "17990988468067466", "text": "@example.user.2 one for you to try with your 😎", "likes": 14, "reply_count": 4, "created_at": "2026-10-21T16:16:07+00:00", "liked_by_author": true, "author": { "uid_hash": "a654f623b259", "nickname": "L***r", "uid": "70000000001", "username": "example.user.1" } } ], "cursor": "BE1fBDYTDBtffUJDQQpDE0UeVR9YQGYfQStHNV9XCw07PwpC", "has_more": true, "total": 2513, "prov": { "hash": "0x35e725afd5c8d284", "ts": "2026-10-22T03:30:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.002000", "balance_usd": "9.998000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.instagram.comments", "x-qovia-title-zh": "Instagram 帖子评论", "x-qovia-description-zh": "帖子的一级评论（按 Instagram 的排序），按游标翻页，每页约 15 条：评论内容、点赞数、回复数、时间（UTC）、是否被作者点赞和评论者。 把上一页返回的 cursor 原样传回即可翻页，has_more 为 false 时停止。回复用 raw.instagram.comment_replies 获取。没有评论或帖子不存在时返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:instagram", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 2000, "usd_per_call": "0.002000", "usd_per_1k": "2" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.instagram.comments/" } }, "/v1/raw/instagram/comment_replies": { "get": { "operationId": "raw_instagram_comment_replies", "summary": "Instagram comment replies", "description": "Replies under one comment, cursor-paginated, about 8 a page: text, likes, time (UTC), whether the author liked it, the reply it answers, and the replier. Pass the post's link or shortcode and the comment's cid. Pass the previous page's cursor back unchanged to continue; stop when has_more is false. A comment without replies, or one that does not exist, answers empty and is not charged.", "tags": [ "Instagram" ], "parameters": [ { "name": "post", "in": "query", "required": true, "description": "The link or shortcode of the comment's post", "x-qovia-description-zh": "评论所在帖子的链接或 shortcode", "schema": { "type": "string", "maxLength": 400, "pattern": "^(?:(?=[0-9]*[A-Za-z_-])[A-Za-z0-9_-]{5,40}|https?://(?:www\\.|m\\.)?instagram\\.com/(?:[A-Za-z0-9._]{1,30}/)?(?:p|reels?|tv)/[A-Za-z0-9_-]{5,40}/?(?:\\?[A-Za-z0-9=&%._-]{0,300})?)$", "examples": [ "DewxhTugF2T" ] }, "example": "DewxhTugF2T" }, { "name": "comment_id", "in": "query", "required": true, "description": "The first-level comment's cid (from the post comments endpoint)", "x-qovia-description-zh": "一级评论的 cid（来自 Instagram 帖子评论接口）", "schema": { "type": "string", "pattern": "^[0-9]{15,20}$", "examples": [ "17990988468067466" ] }, "example": "17990988468067466" }, { "name": "cursor", "in": "query", "required": false, "description": "The cursor from the previous page's response, unchanged; leave it out for the first page", "x-qovia-description-zh": "取上一页响应的 cursor，原样传回；第一页不传", "schema": { "type": "string", "maxLength": 4000, "pattern": "^[A-Za-z0-9_=+/-]+$" } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "cid": "17951280948057079", "text": "@example.user.1 ahh sure, easy 😮", "likes": 0, "reply_count": null, "created_at": "2026-10-21T16:43:37+00:00", "liked_by_author": false, "author": { "uid_hash": "bb8000ceb0ca", "nickname": "H***s", "uid": "70000000002", "username": "example.user.2" }, "parent_cid": "17990988468067466", "reply_to_cid": null }, { "cid": "18108452606216598", "text": "ready to see that POV", "likes": 0, "reply_count": null, "created_at": "2026-10-21T18:54:08+00:00", "liked_by_author": false, "author": { "uid_hash": "43ad409b8d10", "nickname": "Oakley | Meta", "uid": "68825295038", "username": "oakleymeta" }, "parent_cid": "17990988468067466", "reply_to_cid": null } ], "cursor": null, "has_more": false, "total": 4, "prov": { "hash": "0xe7d8183927d4d375", "ts": "2026-10-22T03:30:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.002000", "balance_usd": "9.998000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.instagram.comment_replies", "x-qovia-title-zh": "Instagram 评论回复", "x-qovia-description-zh": "某条评论下的回复，按游标翻页，每页约 8 条：回复内容、点赞数、时间（UTC）、是否被作者点赞、回复对象和回复者。 传帖子链接或 shortcode 和评论的 cid。把上一页返回的 cursor 原样传回即可翻页，has_more 为 false 时停止。没有回复或评论不存在时返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:instagram", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 2000, "usd_per_call": "0.002000", "usd_per_1k": "2" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.instagram.comment_replies/" } }, "/v1/raw/instagram/user": { "get": { "operationId": "raw_instagram_user", "summary": "Instagram user profile", "description": "An Instagram user's profile: followers, following, post count, verification, bio, category, whether the account is private or a business, the links in the bio and the avatar. Pass the username (instagram.com/). A user that does not exist answers 404 and is not charged.", "tags": [ "Instagram" ], "parameters": [ { "name": "username", "in": "query", "required": true, "description": "The username (from instagram.com/, without @)", "x-qovia-description-zh": "用户名（主页链接 instagram.com/<用户名> 里的部分，不带 @）", "schema": { "type": "string", "pattern": "^[A-Za-z0-9._]{1,30}$", "examples": [ "instagram" ] }, "example": "instagram" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "uid_hash": "1c8ec1290d27", "nickname": "Instagram", "followers": 686515583, "posts": 8622, "verified": true, "platform": "instagram", "uid": "25025320", "username": "instagram", "following": 157, "signature": "Discover what's new on Instagram 🔎✨", "category": null, "is_private": false, "is_business": false, "links": [ { "title": null, "url": "http://help.instagram.com" }, { "title": "Close Friends Only with @kaicenat and @kaiyacenat | Spotify", "url": "https://open.spotify.com/episode/6B8XsGCYuHMYzSLvLMitS7?si=kXd6_Y6AQhueoC_McepSKg" }, { "title": "Close Friends Only with @kaicenat and @kaiyacenat | YouTube", "url": "https://www.youtube.com/watch?v=z0X36mIbyCo" } ], "avatar_url": "https://instagram.fmed1-1.fna.fbcdn.net/v/t51.82787-19/550891366_18667771684001321_1383210656577177067_n.jpg?stp=dst-jpg_s320x320_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=instagram.fmed1-1.fna.fbcdn.net&_nc_cat=1&_nc_oc=Q6cZ2gHxA7alZTt1KD68Vi6nu_AjirqNFPZRr3fltDbI5UYmgvBAjkIu7IPlYQjW5w-p94E&_nc_ohc=EH2t9XyJry8Q7kNvwGPGs3A&_nc_gid=L4WYrLzzZILSFohLoLqT6A&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AQMCVp62TTZUnNmWSp_j8e3-UrndLjmGRYtqlD0qmKToBg&oe=6ADEDAE7&_nc_sid=8b3546", "url": "https://www.instagram.com/instagram/", "prov": { "hash": "0x2a08be02b825b88c", "ts": "2026-10-22T03:30:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.instagram.user", "x-qovia-title-zh": "Instagram 用户资料", "x-qovia-description-zh": "Instagram 用户主页资料：粉丝、关注、帖子数、认证、简介、分类、是否私密账号、是否商业账号、简介里的链接和头像。传用户名（instagram.com/<用户名>）。 用户不存在时返回 404，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:instagram", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.instagram.user/" } }, "/v1/raw/instagram/user_posts": { "get": { "operationId": "raw_instagram_user_posts", "summary": "Instagram user posts", "description": "The posts on a user's profile, the ones the user pinned first, then newest first, 12 a page, as the same records as post detail (same ids) plus saves (videos) and whether the user pinned the post; collab posts the user co-authored carry their publisher as author. The counts of the newest posts can trail post detail by a few hours. Pass either the username or the user ID. Pass the previous page's cursor back unchanged to continue; stop when has_more is false. A user without posts, or one that does not exist, answers empty and is not charged. Some parameters depend on each other; see x-qovia-params-schema.", "tags": [ "Instagram" ], "parameters": [ { "name": "username", "in": "query", "required": false, "description": "The username (without @); pass this or user_id", "x-qovia-description-zh": "用户名（不带 @）；与 user_id 二选一", "schema": { "type": "string", "pattern": "^[A-Za-z0-9._]{1,30}$", "examples": [ "instagram" ] }, "example": "instagram" }, { "name": "user_id", "in": "query", "required": false, "description": "The user ID (a profile's uid); pass this or username", "x-qovia-description-zh": "用户 ID（用户资料的 uid）；与 username 二选一", "schema": { "type": "string", "pattern": "^[0-9]{1,20}$" } }, { "name": "cursor", "in": "query", "required": false, "description": "The cursor from the previous page's response, unchanged; leave it out for the first page", "x-qovia-description-zh": "取上一页响应的 cursor，原样传回；第一页不传", "schema": { "type": "string", "maxLength": 4000, "pattern": "^[A-Za-z0-9_=+/-]+$" } } ], "x-qovia-params-schema": { "type": "object", "additionalProperties": false, "properties": { "username": { "type": "string", "pattern": "^[A-Za-z0-9._]{1,30}$", "description": "The username (without @); pass this or user_id", "x-qovia-description-zh": "用户名（不带 @）；与 user_id 二选一", "examples": [ "instagram" ] }, "user_id": { "type": "string", "pattern": "^[0-9]{1,20}$", "description": "The user ID (a profile's uid); pass this or username", "x-qovia-description-zh": "用户 ID（用户资料的 uid）；与 username 二选一" }, "cursor": { "type": "string", "maxLength": 4000, "pattern": "^[A-Za-z0-9_=+/-]+$", "description": "The cursor from the previous page's response, unchanged; leave it out for the first page", "x-qovia-description-zh": "取上一页响应的 cursor，原样传回；第一页不传" } }, "oneOf": [ { "required": [ "username" ] }, { "required": [ "user_id" ] } ] }, "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "id": "soc_ins_c4228c88178e", "src": "social", "platform": "instagram", "lang": null, "text": "we said yes 🎉🎉🎉 (with help from @muse)", "author": { "uid_hash": "1c8ec1290d27", "followers": null, "nickname": "Instagram", "uid": "25025320", "username": "instagram" }, "metrics": { "likes": 264579, "comments": 4685 }, "extra": { "source_id": "3994809802840683658", "shortcode": "DdwalmrkTSK", "published_at": "2026-09-26T16:01:00+00:00", "content_type": "carousel", "topic": null, "topics": [], "images": [ "https://scontent-cph2-1.cdninstagram.com/v/t51.82787-15/825322636_18797172301001321_1840526250724222048_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=111&ig_cache_key=Mzk5NDgwNDgyNTExOTY5NDkzNw%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNBUk9VU0VMX0lURU0ueHBpZHMuMTA4MC5zZHIucmVndWxhcl9waG90by5DMyJ9&_nc_ohc=dE0BpUU0xeEQ7kNvwElBvdx&_nc_oc=AdrbMtwC8_rchUMQ9OfbTLJRWbfcR5ADeuixjEN-vWZo91sXAX9ujO5Bp2IE7d8lNyw&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&se=7&_nc_ht=scontent-cph2-1.cdninstagram.com&_nc_gid=6Rps2g5erRxYSo_TATWYcw&_nc_ss=703ba&oh=00_AQNJIeHBnUZb4jW9_Y0CcHyTzz0YMjGvtsXk4oT-NyhpxA&oe=6ADEE7E8", "https://scontent-cph2-1.cdninstagram.com/v/t51.82787-15/825323018_18797175124001321_7311944808548486139_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=107&ig_cache_key=Mzk5NDgwOTc2OTIwNTg4MTk1Mw%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNBUk9VU0VMX0lURU0ueHBpZHMuMTA4MC5zZHIucmVndWxhcl9waG90by5DMyJ9&_nc_ohc=oiRKhL7ZG24Q7kNvwHQKn5K&_nc_oc=Adr5SiehGbMGUS2nMll10qsYLgLhPPZbs8cOXrcqzjFwvHpVGk7C7xTler-Et0PGYeU&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&se=7&_nc_ht=scontent-cph2-1.cdninstagram.com&_nc_gid=6Rps2g5erRxYSo_TATWYcw&_nc_ss=703ba&oh=00_AQNiEnJM-4xA0NSG8Km1q0vrTFsja0-f7FS0cjnSgBBAzA&oe=6ADEFCDB", "https://scontent-cph2-1.cdninstagram.com/v/t51.82787-15/825322962_18797175115001321_2105147553826773819_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=107&ig_cache_key=Mzk5NDgwOTc3MDQzMDU2ODQwNA%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNBUk9VU0VMX0lURU0ueHBpZHMuMTA4MC5zZHIucmVndWxhcl9waG90by5DMyJ9&_nc_ohc=U1qqjraYXk4Q7kNvwHSAqCj&_nc_oc=Adr6E7BUw2c-RMiS-nFj8E45KM-b1xxo0P8BCRFv8P_qWCH9j1XIBfBQTwN7QfLJjSE&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&se=7&_nc_ht=scontent-cph2-1.cdninstagram.com&_nc_gid=6Rps2g5erRxYSo_TATWYcw&_nc_ss=703ba&oh=00_AQMwUEYzVAa1AQ5-rA6wLjNEvFQVyCi_5Ejcikhrq-z3iA&oe=6ADED754" ], "cover_url": "https://scontent-cph2-1.cdninstagram.com/v/t51.82787-15/825322636_18797172301001321_1840526250724222048_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=111&ig_cache_key=Mzk5NDgwNDgyNTExOTY5NDkzNw%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNBUk9VU0VMX0lURU0ueHBpZHMuMTA4MC5zZHIucmVndWxhcl9waG90by5DMyJ9&_nc_ohc=dE0BpUU0xeEQ7kNvwElBvdx&_nc_oc=AdrbMtwC8_rchUMQ9OfbTLJRWbfcR5ADeuixjEN-vWZo91sXAX9ujO5Bp2IE7d8lNyw&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&se=7&_nc_ht=scontent-cph2-1.cdninstagram.com&_nc_gid=6Rps2g5erRxYSo_TATWYcw&_nc_ss=703ba&oh=00_AQNJIeHBnUZb4jW9_Y0CcHyTzz0YMjGvtsXk4oT-NyhpxA&oe=6ADEE7E8", "video_dur_s": null, "location": null, "url": "https://www.instagram.com/p/DdwalmrkTSK/", "pinned": false }, "prov": { "hash": "0xfb163e582a0072d3", "ts": "2026-10-22T03:30:00+08:00", "source": "live" } }, { "id": "soc_ins_b3e6797aecd1", "src": "social", "platform": "instagram", "lang": null, "text": "Saved posts → an actual collection 📌\n\nConnect your Instagram and @muse and it can sort them by theme, so your interior design inspo isn’t buried under recipes.", "author": { "uid_hash": "1c8ec1290d27", "followers": null, "nickname": "Instagram", "uid": "25025320", "username": "instagram" }, "metrics": { "likes": 80975, "comments": 4410, "shares": 7029, "saves": 5585, "plays": 49213697 }, "extra": { "source_id": "3994748868695958823", "shortcode": "DdwMu5VhCUn", "published_at": "2026-09-26T14:03:22+00:00", "content_type": "video", "topic": null, "topics": [], "images": [], "cover_url": "https://scontent-cph2-1.cdninstagram.com/v/t51.82787-15/825320587_18797135827001321_2410519140595393030_n.jpg?stp=dst-jpg_e15_s640x640_tt6&_nc_cat=106&ig_cache_key=Mzk5NDc0ODg2ODY5NTk1ODgyMzE4Nzk3MTM1ODIxMDAxMzIx.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLnhwaWRzLjEwODAuc2RyLnZpZGVvX3VzZXJfdXBsb2FkZWRfdGh1bWJuYWlsLkMzIn0%3D&_nc_ohc=N8IYvCcHMvQQ7kNvwF9zNC4&_nc_oc=AdqEtJ0IOUfasc1t4spxHrjASfJyeQxG4whMRmYR-_TsB5nuMmOw6RJfOBSFli3IoJE&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-cph2-1.cdninstagram.com&_nc_gid=6Rps2g5erRxYSo_TATWYcw&_nc_ss=703ba&oh=00_AQPorMZDg5mi9QGPS6ujUFSc971vZpevgoI7D13lqqC7jg&oe=6ADEE01E", "video_dur_s": 12, "location": null, "url": "https://www.instagram.com/p/DdwMu5VhCUn/", "pinned": false }, "prov": { "hash": "0xef40f1d459c686f2", "ts": "2026-10-22T03:30:00+08:00", "source": "live" } } ], "cursor": "D01MBAwpDhZIZQNSHV1DRj5GHUM3QRdGF1wqbk9cR0tIWANH", "has_more": true, "prov": { "hash": "0xbc6db7dfa2ed93aa", "ts": "2026-10-22T03:30:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.002000", "balance_usd": "9.998000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.instagram.user_posts", "x-qovia-title-zh": "Instagram 用户帖子列表", "x-qovia-description-zh": "一个用户主页上的帖子，该用户置顶的在前，其余从新到旧，每页 12 条，记录与帖子详情相同（同一 id），另有收藏数（视频）和是否被该用户置顶；该用户参与合作的帖子以发布者为作者。最新帖子的数据可能比帖子详情晚几个小时。 传用户名或用户 ID 其中一个。把上一页返回的 cursor 原样传回即可翻页，has_more 为 false 时停止。没有帖子或用户不存在时返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:instagram", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 2000, "usd_per_call": "0.002000", "usd_per_1k": "2" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.instagram.user_posts/" } }, "/v1/raw/instagram/hashtag_posts": { "get": { "operationId": "raw_instagram_hashtag_posts", "summary": "Instagram hashtag posts", "description": "The newest posts carrying a hashtag, about 30 a page, as the same records as post detail (same ids) with the author's user ID only and no plays, shares or carousel slides; total is how many posts carry the hashtag. Pass the previous page's cursor back unchanged to continue; stop when has_more is false. A hashtag nobody used answers empty and is not charged.", "tags": [ "Instagram" ], "parameters": [ { "name": "hashtag", "in": "query", "required": true, "description": "The hashtag (without", "x-qovia-description-zh": "话题标签（不带", "schema": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[^\\s#@,.!?&/\\\\]+$", "examples": [ "travel" ] }, "example": "travel" }, { "name": "cursor", "in": "query", "required": false, "description": "The cursor from the previous page's response, unchanged; leave it out for the first page", "x-qovia-description-zh": "取上一页响应的 cursor，原样传回；第一页不传", "schema": { "type": "string", "maxLength": 4000, "pattern": "^[A-Za-z0-9_=+/-]+$" } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "id": "soc_ins_e553866650de", "src": "social", "platform": "instagram", "lang": null, "text": "A operação começará em 15 de dezembro de 2027, com três voos semanais ✨. Confira mais no link da bio 🔗. #qatarairways✈️ #travel #explorepage #viagens #informaçao", "author": { "uid_hash": "b0d64510d3d2", "followers": null, "nickname": null, "uid": "70000000003", "username": null }, "metrics": { "likes": 0, "comments": 0 }, "extra": { "source_id": "4013029541808673639", "shortcode": "DexJRs4p5Nn", "published_at": "2026-10-21T19:22:27+00:00", "content_type": "image_post", "topic": "#qatarairways", "topics": [ "qatarairways", "travel", "explorepage", "viagens", "informaçao" ], "images": [ "https://scontent-cdg4-3.cdninstagram.com/v/t51.82787-15/862325060_17969227299194626_1865856716945445925_n.jpg?stp=dst-jpg_e35_p1080x1080_sh2.08_tt6&_nc_ht=scontent-cdg4-3.cdninstagram.com&_nc_cat=110&_nc_oc=Q6cZ2gFu66BjcgkXs06g_kLZSs1VgZr9JgkAe58tT7iSkO83az2T6VlkE9mvU1e4irp8-eY&_nc_ohc=pVziCq2jNiYQ7kNvwGHAGs9&_nc_gid=NpyjTo1tYiCXYX7t_Ah8HQ&edm=AA0rjkIBAAAA&ccb=7-5&ig_cache_key=NDAxMzAyOTU0MTgwODY3MzYzOQ%3D%3D.3-ccb7-5&oh=00_AQMFcTm3HBQhDIK992wWP88uVgF9WF7n3W1qBSoOqCCrjA&oe=6ADEEB6C&_nc_sid=49ed71" ], "cover_url": "https://scontent-cdg4-3.cdninstagram.com/v/t51.82787-15/862325060_17969227299194626_1865856716945445925_n.jpg?stp=dst-jpg_e35_p1080x1080_sh2.08_tt6&_nc_ht=scontent-cdg4-3.cdninstagram.com&_nc_cat=110&_nc_oc=Q6cZ2gFu66BjcgkXs06g_kLZSs1VgZr9JgkAe58tT7iSkO83az2T6VlkE9mvU1e4irp8-eY&_nc_ohc=pVziCq2jNiYQ7kNvwGHAGs9&_nc_gid=NpyjTo1tYiCXYX7t_Ah8HQ&edm=AA0rjkIBAAAA&ccb=7-5&ig_cache_key=NDAxMzAyOTU0MTgwODY3MzYzOQ%3D%3D.3-ccb7-5&oh=00_AQMFcTm3HBQhDIK992wWP88uVgF9WF7n3W1qBSoOqCCrjA&oe=6ADEEB6C&_nc_sid=49ed71", "video_dur_s": null, "location": null, "url": "https://www.instagram.com/p/DexJRs4p5Nn/" }, "prov": { "hash": "0x69439966f886432e", "ts": "2026-10-22T03:30:00+08:00", "source": "live" } }, { "id": "soc_ins_9e233058428f", "src": "social", "platform": "instagram", "lang": null, "text": "Ho Chi Minh City 🇻🇳\n\n#vietnam #travel #travelgram #traveling #asia", "author": { "uid_hash": "48f38f8bd1b9", "followers": null, "nickname": null, "uid": "70000000004", "username": null }, "metrics": { "likes": 0, "comments": 0 }, "extra": { "source_id": "4013029633108641592", "shortcode": "DexJTB6joc4", "published_at": "2026-10-21T19:20:33+00:00", "content_type": "carousel", "topic": "#vietnam", "topics": [ "vietnam", "travel", "travelgram", "traveling", "asia" ], "images": [], "cover_url": "https://scontent-cdg4-2.cdninstagram.com/v/t51.82787-15/848153455_18131539450760347_2769299367844032000_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-cdg4-2.cdninstagram.com&_nc_cat=107&_nc_oc=Q6cZ2gFu66BjcgkXs06g_kLZSs1VgZr9JgkAe58tT7iSkO83az2T6VlkE9mvU1e4irp8-eY&_nc_ohc=9JrWVnKeOG0Q7kNvwEg65mt&_nc_gid=NpyjTo1tYiCXYX7t_Ah8HQ&edm=AA0rjkIBAAAA&ccb=7-5&oh=00_AQNU4dxI33qBLM7cfR28bzseoivZX_Esq4vQ-4W_ueHPcQ&oe=6ADEFEEF&_nc_sid=49ed71", "video_dur_s": null, "location": null, "url": "https://www.instagram.com/p/DexJTB6joc4/" }, "prov": { "hash": "0xa5fd1bf8ffbdf901", "ts": "2026-10-22T03:30:00+08:00", "source": "live" } } ], "cursor": "QVFDOFBiU2ptS3k0bUVqMy1WR29XWjkxbzlpemx3ZjBtMjdF", "has_more": true, "total": 798248141, "prov": { "hash": "0x63da10b488f692b2", "ts": "2026-10-22T03:30:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.instagram.hashtag_posts", "x-qovia-title-zh": "Instagram 话题帖子", "x-qovia-description-zh": "带某个话题标签的最新帖子，每页约 30 条，记录与帖子详情相同（同一 id），作者只有用户 ID，没有播放量、分享数和轮播各页图片；total 为带该标签的帖子总数。 把上一页返回的 cursor 原样传回即可翻页，has_more 为 false 时停止。没有人用过的标签返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:instagram", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.instagram.hashtag_posts/" } }, "/v1/raw/x/post": { "get": { "operationId": "raw_x_post", "summary": "X post detail", "description": "One X (Twitter) post: full text, language, author, like / reply / repost / quote / bookmark / view counts, hashtags, images, video cover and duration, links, the post it replies to, the reposted or quoted post, publish time (UTC) and link. A post that does not exist or cannot be seen answers 400 and is not charged; a single 400 can also be a passing failure, so ask again.", "tags": [ "X (Twitter)" ], "parameters": [ { "name": "post_id", "in": "query", "required": true, "description": "The post's ID (the number in x.com//status/)", "x-qovia-description-zh": "帖子 ID（链接 x.com/<用户名>/status/ 里的数字）", "schema": { "type": "string", "pattern": "^[1-9][0-9]{0,19}$", "examples": [ "2112560723603632217" ] }, "example": "2112560723603632217" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "id": "soc_x_88c4e895916c", "src": "social", "platform": "x", "lang": "en", "text": "There's a lot of ground to cover when you're building a Moon Base. \n\nDuring the first phase of @NASAMoonBase development, robotic rovers will gather new details about the lunar South Pole region, while lunar terrain vehicles will extend the reach of each Artemis mission. https://t.co/tal41Kyght", "author": { "uid_hash": "99eae2f7b3d7", "followers": 92313359, "nickname": "NASA", "uid": "11348282", "unique_id": "NASA" }, "metrics": { "likes": 3365, "comments": 230, "shares": 492, "quotes": 59, "saves": 179, "views": 519079 }, "extra": { "source_id": "2112560723603632217", "published_at": "2026-10-20T15:05:00+00:00", "content_type": "video", "topic": null, "topics": [], "images": [], "cover_url": "https://pbs.twimg.com/media/HVFSyBvWAAE5Y1_.jpg", "video_dur_s": 46, "links": [], "reply_to": null, "conversation_id": "2112560723603632217", "sensitive": false, "repost_of": null, "quote_of": null, "url": "https://x.com/NASA/status/2112560723603632217" }, "prov": { "hash": "0x4e5629f2f5dedf8f", "ts": "2026-10-22T03:30:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.x.post", "x-qovia-title-zh": "X 帖子详情", "x-qovia-description-zh": "单条 X（Twitter）帖子：全文、语言、作者、点赞/回复/转发/引用/收藏/浏览数、话题标签、图片、视频封面和时长、外链、回复的帖子、被转发或引用的原帖、发布时间（UTC）和链接。 帖子不存在或无法查看时返回 400，不计费；偶尔一次 400 也可能是临时失败，重试即可。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:x", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.x.post/" } }, "/v1/raw/x/comments": { "get": { "operationId": "raw_x_comments", "summary": "X post replies", "description": "Replies to a post (X's comments) in X's relevance order, up to about 40 a page: text, likes, reply count, images, time (UTC) and the replier. Pass the previous page's cursor back to continue; stop when has_more is false. Replies are posts too: pass a cid as post_id to get its own replies. A post without replies answers empty and one that does not exist answers 400; neither is charged.", "tags": [ "X (Twitter)" ], "parameters": [ { "name": "post_id", "in": "query", "required": true, "description": "The post's ID (the number in x.com//status/)", "x-qovia-description-zh": "帖子 ID（链接 x.com/<用户名>/status/ 里的数字）", "schema": { "type": "string", "pattern": "^[1-9][0-9]{0,19}$", "examples": [ "2112560723603632217" ] }, "example": "2112560723603632217" }, { "name": "cursor", "in": "query", "required": false, "description": "The cursor from the previous page's response; leave it out for the first page", "x-qovia-description-zh": "取上一页响应的 cursor；第一页不传", "schema": { "type": "string", "pattern": "^[A-Za-z0-9_=+/-]{16,2048}$" } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "cid": "2112560726397092239", "text": "@NASAMoonBase The journey is just beginning. See how NASA and our partners are getting @NASAMoonBase moving in the full video: https://t.co/oI5pwU8Fyz", "likes": 429, "reply_count": 12, "created_at": "2026-10-20T15:05:01+00:00", "images": [], "author": { "uid_hash": "99eae2f7b3d7", "nickname": "NASA", "uid": "11348282", "unique_id": "NASA" } }, { "cid": "2112612259579191731", "text": "@NASA @NASAMoonBase Great Moon Base progress!", "likes": 409, "reply_count": 12, "created_at": "2026-10-20T18:29:47+00:00", "images": [], "author": { "uid_hash": "264760c8afaa", "nickname": "NASA Administrator Jared Isaacman", "uid": "2000593641480605696", "unique_id": "NASAAdmin" } } ], "cursor": "DAAKCgABHVLXUzf__m0LAAIAAAGoRW1QQzZ3QUFBZlEvZ0dKTjB2R3AvQUFBQUNVZFVWNjEvNWRRUGgxUmNsdEEyNEY5SFZGbkZGUWFNY3NkVW1GMCs1cFFnaDFSV2o5dUc3RjZIVkZ0NThoYkFac2RVWUdvTUZwaHN4MVJZNk5CRzZFN0hWRjBFVU5ic1FrZFVWVGc3VllSd1IxUlZIUUVGNEdCSFZIS0VhZ1hNUUlkVW1jcng5dGdNeDFSWTMxZzIzRjFIVkY4eU9rYTRjb2RVWFRzbHhaeGF4MVJWaVBnMnJIMkhWRmRkS3Zid1hFZFVWMlFnMWJnS2gxUlcrdTNGMkZuSFZGWVBjM2E0YXNkVVZqZExwcFFXUjFSZ05qM1d2R1lIVkZTeWE5WEFZOGRVV2xpQWRlUVFoMVJjWHhrVnNFbUhWRmR3S29hWUswZFVtdHN5MWZCUEIxUlhjbEZteUFESFZGMTE5QVdNVlFkVVZpdVFOWndOaDFTdUR0SG02QXFIVkhWSjEzVzBIVWRVVy8xaFpveHZSMVJVc2tJMWpCWkhWRlppMURic1h3ZFVWUHhpRnNROXc9PQgAAwAAAAILAAQAAAAGQm90dG9tAAA", "has_more": true, "total": 230, "prov": { "hash": "0xd103ab1a2af6d6e1", "ts": "2026-10-22T03:30:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.x.comments", "x-qovia-title-zh": "X 帖子回复", "x-qovia-description-zh": "帖子下的回复（X 的评论），按 X 的相关度排序，每页最多约 40 条：回复内容、点赞数、回复数、图片、时间（UTC）和回复者。 把上一页返回的 cursor 传回即可翻页，has_more 为 false 时停止。回复也是帖子，可以把 cid 当作 post_id 继续取它的回复。没有回复时返回空结果，帖子不存在时返回 400，均不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:x", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.x.comments/" } }, "/v1/raw/x/user": { "get": { "operationId": "raw_x_user", "summary": "X user profile", "description": "An X user's profile with followers, following, post count, verification (the blue check and the government or business type), bio, location, website, join time (UTC), avatar, banner and whether the account is protected. Pass either the handle (x.com/) or the numeric uid. A user that does not exist answers 404 and is not charged. Some parameters depend on each other; see x-qovia-params-schema.", "tags": [ "X (Twitter)" ], "parameters": [ { "name": "unique_id", "in": "query", "required": false, "description": "The handle (from x.com/, without the @); pass this or uid", "x-qovia-description-zh": "用户名（主页链接 x.com/<用户名> 里的部分，不带 @）；与 uid 二选一", "schema": { "type": "string", "pattern": "^[A-Za-z0-9_]{1,15}$", "examples": [ "NASA" ] }, "example": "NASA" }, { "name": "uid", "in": "query", "required": false, "description": "The user's numeric ID (author.uid in the records); pass this or unique_id", "x-qovia-description-zh": "用户的数字 ID（记录里的 author.uid）；与 unique_id 二选一", "schema": { "type": "string", "pattern": "^[1-9][0-9]{0,19}$" } } ], "x-qovia-params-schema": { "type": "object", "additionalProperties": false, "properties": { "unique_id": { "type": "string", "pattern": "^[A-Za-z0-9_]{1,15}$", "description": "The handle (from x.com/, without the @); pass this or uid", "x-qovia-description-zh": "用户名（主页链接 x.com/<用户名> 里的部分，不带 @）；与 uid 二选一", "examples": [ "NASA" ] }, "uid": { "type": "string", "pattern": "^[1-9][0-9]{0,19}$", "description": "The user's numeric ID (author.uid in the records); pass this or unique_id", "x-qovia-description-zh": "用户的数字 ID（记录里的 author.uid）；与 unique_id 二选一" } }, "oneOf": [ { "required": [ "unique_id" ] }, { "required": [ "uid" ] } ] }, "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "uid_hash": "99eae2f7b3d7", "nickname": "NASA", "followers": 92313358, "posts": 74446, "verified": true, "platform": "x", "uid": "11348282", "unique_id": "NASA", "following": 115, "signature": "Making the seemingly impossible, possible. ✨", "verify_reason": "Government", "location": "Pale Blue Dot", "website": "http://www.nasa.gov/", "created_at": "2007-12-19T20:20:32+00:00", "protected": false, "avatar_url": "https://pbs.twimg.com/profile_images/1321163587679784960/0ZxKlEKB_400x400.jpg", "banner_url": "https://pbs.twimg.com/profile_banners/11348282/1788992290", "url": "https://x.com/NASA", "prov": { "hash": "0x5f0696afaa47c688", "ts": "2026-10-22T03:30:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.x.user", "x-qovia-title-zh": "X 用户资料", "x-qovia-description-zh": "X 用户主页资料：粉丝、关注、发帖数、认证（蓝标及政府/企业认证类型）、简介、所在地、网站、注册时间（UTC）、头像、背景图和是否受保护。传用户名（x.com/<用户名>）或数字 uid 其中一个。 用户不存在时返回 404，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:x", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.x.user/" } }, "/v1/raw/x/user_posts": { "get": { "operationId": "raw_x_user_posts", "summary": "X user posts", "description": "Posts and reposts a user published, the pinned post first on the first page, then newest first, about 20 a page, as the same records as post detail (same ids); a repost (content_type repost) carries its counts in extra.repost_of. Pass the previous page's cursor back to continue; stop when has_more is false. A page can answer 400 once: ask again. Pass either the handle or the numeric uid. A user that does not exist answers 400 and is not charged. Some parameters depend on each other; see x-qovia-params-schema.", "tags": [ "X (Twitter)" ], "parameters": [ { "name": "unique_id", "in": "query", "required": false, "description": "The handle (from x.com/, without the @); pass this or uid", "x-qovia-description-zh": "用户名（主页链接 x.com/<用户名> 里的部分，不带 @）；与 uid 二选一", "schema": { "type": "string", "pattern": "^[A-Za-z0-9_]{1,15}$", "examples": [ "NASA" ] }, "example": "NASA" }, { "name": "uid", "in": "query", "required": false, "description": "The user's numeric ID (author.uid in the records); pass this or unique_id", "x-qovia-description-zh": "用户的数字 ID（记录里的 author.uid）；与 unique_id 二选一", "schema": { "type": "string", "pattern": "^[1-9][0-9]{0,19}$" } }, { "name": "cursor", "in": "query", "required": false, "description": "The cursor from the previous page's response; leave it out for the first page", "x-qovia-description-zh": "取上一页响应的 cursor；第一页不传", "schema": { "type": "string", "pattern": "^[A-Za-z0-9_=+/-]{16,2048}$" } } ], "x-qovia-params-schema": { "type": "object", "additionalProperties": false, "properties": { "unique_id": { "type": "string", "pattern": "^[A-Za-z0-9_]{1,15}$", "description": "The handle (from x.com/, without the @); pass this or uid", "x-qovia-description-zh": "用户名（主页链接 x.com/<用户名> 里的部分，不带 @）；与 uid 二选一", "examples": [ "NASA" ] }, "uid": { "type": "string", "pattern": "^[1-9][0-9]{0,19}$", "description": "The user's numeric ID (author.uid in the records); pass this or unique_id", "x-qovia-description-zh": "用户的数字 ID（记录里的 author.uid）；与 unique_id 二选一" }, "cursor": { "type": "string", "pattern": "^[A-Za-z0-9_=+/-]{16,2048}$", "description": "The cursor from the previous page's response; leave it out for the first page", "x-qovia-description-zh": "取上一页响应的 cursor；第一页不传" } }, "oneOf": [ { "required": [ "unique_id" ] }, { "required": [ "uid" ] } ] }, "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "id": "soc_x_8028d7441f31", "src": "social", "platform": "x", "lang": "en", "text": "\"I just hear over and over again: 'I felt like I went on the mission with you'.\"\n\nArtemis II's Jeremy Hansen and Victor Glover reflect on their historic trip around the Moon — and how life on Earth has been since — in our latest Houston We Have A Podcast: https://t.co/jZ9Zm5P8Z8 https://t.co/A6YIgHFDqB", "author": { "uid_hash": "99eae2f7b3d7", "followers": 92313359, "nickname": "NASA", "uid": "11348282", "unique_id": "NASA" }, "metrics": { "likes": 432, "comments": 59, "shares": 60, "quotes": 9, "saves": 18, "views": 144316 }, "extra": { "source_id": "2112959650551173522", "published_at": "2026-10-21T17:30:12+00:00", "content_type": "image_post", "topic": null, "topics": [], "images": [ "https://pbs.twimg.com/media/HVK9moNWUAAzx2Y.jpg" ], "cover_url": "https://pbs.twimg.com/media/HVK9moNWUAAzx2Y.jpg", "video_dur_s": null, "links": [ "https://go.nasa.gov/4dSkerm" ], "reply_to": null, "conversation_id": "2112959650551173522", "sensitive": false, "repost_of": null, "quote_of": null, "url": "https://x.com/NASA/status/2112959650551173522", "pinned": false }, "prov": { "hash": "0x7f5aa6370cbd4752", "ts": "2026-10-22T03:30:00+08:00", "source": "live" } }, { "id": "soc_x_8b28cb565b02", "src": "social", "platform": "x", "lang": "en", "text": "RT @NASAJohnson: Some moments are worth floating back to. ✨\n\nWhen @NASA’s @SpaceX Crew-13 launched on Oct. 1, they brought along a little e…", "author": { "uid_hash": "99eae2f7b3d7", "followers": 92313359, "nickname": "NASA", "uid": "11348282", "unique_id": "NASA" }, "metrics": { "likes": null, "comments": null, "shares": null, "quotes": null, "saves": null, "views": null }, "extra": { "source_id": "2112634828478611813", "published_at": "2026-10-20T19:59:28+00:00", "content_type": "repost", "topic": null, "topics": [], "images": [], "cover_url": null, "video_dur_s": null, "links": [], "reply_to": null, "conversation_id": "2112634828478611813", "sensitive": null, "repost_of": { "id": "soc_x_5b5e5e233512", "source_id": "2112628310702272570", "text": "Some moments are worth floating back to. ✨\n\nWhen @NASA’s @SpaceX Crew-13 launched on Oct. 1, they brought along a little extra company! 🚀 Meet Lucky, a hand-crocheted golden dragon and the crew’s zero-gravity indicator! These small companions float freely once a spacecraft reaches microgravity, giving astronauts a visual sign that they’re officially weightless.", "author": { "uid_hash": "c2fba03d9d28", "followers": null, "nickname": null, "uid": "50115087", "unique_id": "NASAJohnson" }, "metrics": { "likes": 1132, "comments": 49, "shares": 140, "quotes": 9, "saves": 50, "views": 159973 }, "url": "https://x.com/NASAJohnson/status/2112628310702272570" }, "quote_of": null, "url": "https://x.com/NASA/status/2112634828478611813", "pinned": false }, "prov": { "hash": "0x4e341ea0cdfdd2f6", "ts": "2026-10-22T03:30:00+08:00", "source": "live" } } ], "cursor": "DAAHCgABHVLXNnz__-wLAAIAAAATMjExMDA5OTM0MzUzMzY0MTc2OAgAAwAAAAIAAA", "has_more": true, "prov": { "hash": "0x6b6f5ff82a51d255", "ts": "2026-10-22T03:30:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.x.user_posts", "x-qovia-title-zh": "X 用户发帖列表", "x-qovia-description-zh": "一个用户发布和转发的帖子，第一页置顶帖在前，其余从新到旧，每页约 20 条，记录与帖子详情相同（同一 id）；转发帖（content_type 为 repost）的互动数在 extra.repost_of 里。 把上一页返回的 cursor 传回即可翻页，has_more 为 false 时停止；偶尔某页会返回 400，重试一次即可。传用户名或数字 uid 其中一个。用户不存在时返回 400，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:x", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.x.user_posts/" } }, "/v1/raw/x/search": { "get": { "operationId": "raw_x_search", "summary": "X post search", "description": "Keyword search for X posts in X's top order, optionally only posts with images and videos; the same records as post detail (same ids), authors with their follower counts. X matches more than the text (quoted posts, links and media), so a result may not contain the keyword. About 20 a page; pass the previous page's cursor back to continue and stop when has_more is false. No results answers empty and is not charged.", "tags": [ "X (Twitter)" ], "parameters": [ { "name": "keyword", "in": "query", "required": true, "description": "Search keyword (X's search syntax works, e.g. from:NASA or #hashtag)", "x-qovia-description-zh": "搜索关键词（可用 X 的搜索语法，如 from:NASA、#话题）", "schema": { "type": "string", "minLength": 1, "maxLength": 200, "pattern": "\\S", "examples": [ "Artemis" ] }, "example": "Artemis" }, { "name": "type", "in": "query", "required": false, "description": "Results: top (the default) or media (posts with images and videos only)", "x-qovia-description-zh": "结果：top 热门（默认）、media 只看带图片和视频的帖子", "schema": { "type": "string", "enum": [ "top", "media" ], "default": "top" } }, { "name": "cursor", "in": "query", "required": false, "description": "The cursor from the previous page's response; leave it out for the first page", "x-qovia-description-zh": "取上一页响应的 cursor；第一页不传", "schema": { "type": "string", "pattern": "^[A-Za-z0-9_=+/-]{16,2048}$" } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "id": "soc_x_8028d7441f31", "src": "social", "platform": "x", "lang": "en", "text": "\"I just hear over and over again: 'I felt like I went on the mission with you'.\"\n\nArtemis II's Jeremy Hansen and Victor Glover reflect on their historic trip around the Moon — and how life on Earth has been since — in our latest Houston We Have A Podcast: https://t.co/jZ9Zm5P8Z8 https://t.co/A6YIgHFDqB", "author": { "uid_hash": "99eae2f7b3d7", "followers": 92313360, "nickname": "NASA", "uid": "11348282", "unique_id": "NASA" }, "metrics": { "likes": 433, "comments": 59, "shares": 60, "quotes": 9, "saves": 18, "views": 144683 }, "extra": { "source_id": "2112959650551173522", "published_at": "2026-10-21T17:30:12+00:00", "content_type": "image_post", "topic": null, "topics": [], "images": [ "https://pbs.twimg.com/media/HVK9moNWUAAzx2Y.jpg" ], "cover_url": "https://pbs.twimg.com/media/HVK9moNWUAAzx2Y.jpg", "video_dur_s": null, "links": [ "https://go.nasa.gov/4dSkerm" ], "reply_to": null, "conversation_id": "2112959650551173522", "sensitive": false, "repost_of": null, "quote_of": null, "url": "https://x.com/NASA/status/2112959650551173522" }, "prov": { "hash": "0xb2bf6b75a430dda4", "ts": "2026-10-22T03:30:00+08:00", "source": "live" } }, { "id": "soc_x_af81593ad1d0", "src": "social", "platform": "x", "lang": "en", "text": "Earthshine.\n\nArtemis II astronaut Christina Koch captured this video of Earth outside the windows of the Orion spacecraft during the second flight day of the mission. Orion was roughly 33,800 miles (54,500 km) away from Earth when @Astro_Christina took this video. https://t.co/1YBxVj4hi9", "author": { "uid_hash": "67a17d97abca", "followers": 1208192, "nickname": "NASA Artemis", "uid": "632344577", "unique_id": "NASAArtemis" }, "metrics": { "likes": 39671, "comments": 1155, "shares": 6981, "quotes": 548, "saves": 4922, "views": 2076761 }, "extra": { "source_id": "2047018269446455578", "published_at": "2026-04-22T18:22:41+00:00", "content_type": "video", "topic": null, "topics": [], "images": [], "cover_url": "https://pbs.twimg.com/media/HGh4RARXoAAbk4L.jpg", "video_dur_s": 19, "links": [], "reply_to": null, "conversation_id": "2047018269446455578", "sensitive": false, "repost_of": null, "quote_of": null, "url": "https://x.com/NASAArtemis/status/2047018269446455578" }, "prov": { "hash": "0x492b093d69ae8207", "ts": "2026-10-22T03:30:00+08:00", "source": "live" } } ], "cursor": "DAACCgACHVLXXo_AJxAKAAMdUtdej7_Y8AgABAAAAAILAAUAAADwRW1QQzZ3QUFBZlEvZ0dKTjB2R3AvQUFBQUJRZFRuT0RodFp4Y1J4V2thV0dHckNWSFVsalN3Ulc4T1FkVEJiNWJ0ckFNaDFSVEFZSGx6RzBIR2g0UlQ4WFFSb2RVbDN1eUJmQkRSMVNTaVhuRjVIZ0hVbWFVYmhYSUJBZFVyMmJjOVlSa2gxU3pybmVGbUR3SFV3Q0ZhZlhzTDBkU2grWkpsYUFXUjFNVFVUSlY2R0pIVkZTeVFqV01Ga2RUQU84aFJwQUV4MUNveXl3V3lISUhVOTVPaUlXb0x3ZFF2cGdCQnNSYXgxU0l5bWEyaERxCAAGAAAAAAgABwAAAAAMAAgKAAEcVpGlhhqwlQAAAA", "has_more": true, "prov": { "hash": "0x3b3492d4acaa82b0", "ts": "2026-10-22T03:30:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.x.search", "x-qovia-title-zh": "X 帖子搜索", "x-qovia-description-zh": "按关键词搜索 X 帖子（X 的热门排序），可只看带图片和视频的帖子；记录与帖子详情相同（同一 id），作者带粉丝数。X 的搜索不只匹配正文（也匹配引用的帖子、链接和媒体），结果正文里不一定有关键词。 每页约 20 条，把上一页返回的 cursor 传回即可翻页，has_more 为 false 时停止。没有结果时返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:x", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.x.search/" } }, "/v1/raw/x/trending": { "get": { "operationId": "raw_x_trending", "summary": "X trending", "description": "X's trends for a country in X's order, about 50: the term, its category (Sports, Politics, ...), whether it is a hashtag, and a search link. X shows no count here (heat is null). country is a two-letter country code, us (United States) by default.", "tags": [ "X (Twitter)" ], "parameters": [ { "name": "country", "in": "query", "required": false, "description": "The country (ISO 3166 two-letter code, lower case), us by default; e.g. jp, gb or in", "x-qovia-description-zh": "国家（ISO 3166 两位代码，小写），默认 us；如 jp 日本、gb 英国、in 印度", "schema": { "type": "string", "enum": [ "us", "cn", "in", "jp", "ru", "de", "id", "br", "fr", "gb", "tr", "it", "mx", "kr", "ca", "es", "sa", "eg", "au", "pl", "ir", "pk", "vn", "ng", "bd", "nl", "ar", "ph", "my", "co", "ae", "ro", "be", "ch", "sg", "se", "no", "at", "kz", "dz", "cl", "cz", "pe", "iq", "il", "ua", "dk", "pt", "hu", "gr", "fi", "nz", "by", "sk", "rs", "lt", "lu", "ee" ], "default": "us", "examples": [ "us" ] }, "example": "us" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "rank": 1, "word": "BioWare", "heat": null, "category": "Video games", "is_topic": false, "url": "https://x.com/search?q=BioWare" }, { "rank": 2, "word": "Carrick", "heat": null, "category": "UEFA Europa League", "is_topic": false, "url": "https://x.com/search?q=Carrick" }, { "rank": 3, "word": "DreaminaOnly29Cents", "heat": null, "category": null, "is_topic": true, "url": "https://x.com/search?q=%23DreaminaOnly29Cents" }, { "rank": 4, "word": "Nico Paz", "heat": null, "category": "UEFA Europa League", "is_topic": false, "url": "https://x.com/search?q=Nico%20Paz" } ], "prov": { "hash": "0xce7e024378d841b6", "ts": "2026-10-22T03:30:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.x.trending", "x-qovia-title-zh": "X 趋势榜", "x-qovia-description-zh": "一个国家的 X 趋势（Trending），按 X 的排名，约 50 条：趋势词、分类（如 Sports、Politics）、是否话题标签和搜索链接。X 在这里不提供热度数值（heat 为 null）。 country 用两位国家代码，默认 us（美国）。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:x", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.x.trending/" } }, "/v1/raw/reddit/post": { "get": { "operationId": "raw_reddit_post", "summary": "Reddit post detail", "description": "One Reddit post: title and body (Reddit's markdown), author, subreddit, posted and edited times (UTC), score (upvotes minus downvotes), comment and share counts, upvote ratio, flair, the link it points to, images or the video's length, as the same record as search results (same id). Pass the post's fullname: t3_ plus the ID in reddit.com/r//comments//. A post that does not exist answers 404 and is not charged.", "tags": [ "Reddit" ], "parameters": [ { "name": "post_id", "in": "query", "required": true, "description": "The post's fullname: t3_ plus the ID in reddit.com/r//comments//", "x-qovia-description-zh": "帖子 fullname：t3_ 加上帖子链接 reddit.com/r/<版块>/comments// 里的 ID", "schema": { "type": "string", "pattern": "^t3_[a-z0-9]{1,17}$", "examples": [ "t3_1xbt833" ] }, "example": "t3_1xbt833" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "id": "soc_red_1a750cbda069", "src": "social", "platform": "reddit", "lang": "en", "text": "New Airbnb rules ban hosts from making guests wash dishes, do laundry & other checkout chores", "author": { "uid_hash": "299b37f83b60", "followers": null, "nickname": "example_user_1", "uid": "t2_00000001", "username": "example_user_1" }, "metrics": { "likes": 11382, "comments": 907, "shares": 615 }, "extra": { "source_id": "t3_1xbt833", "title": "New Airbnb rules ban hosts from making guests wash dishes, do laundry & other checkout chores", "subreddit": "technology", "subreddit_id": "t5_2qh16", "published_at": "2026-10-21T17:16:38+00:00", "updated_at": null, "content_type": "link", "flair": "Society", "nsfw": false, "upvote_ratio": 0.9885, "link_url": "https://www.dexerto.com/entertainment/new-airbnb-rules-ban-hosts-from-making-guests-wash-dishes-do-laundry-other-checkout-chores-3420832/", "images": [], "cover_url": "https://external-preview.redd.it/iG4DQyrHGxTy2LRE2VubxlYmgRAnybJEOboepBlhvDs.jpeg?auto=webp&s=09d1608dce5f50c3ff462222b1065ac67fc70cfd", "video_dur_s": null, "truncated": false, "url": "https://www.reddit.com/r/technology/comments/1xbt833/new_airbnb_rules_ban_hosts_from_making_guests/" }, "prov": { "hash": "0x622bd1a221d4a3a9", "ts": "2026-10-22T03:30:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.reddit.post", "x-qovia-title-zh": "Reddit 帖子详情", "x-qovia-description-zh": "单个 Reddit 帖子：标题与正文（Reddit 的 markdown）、作者、所在版块、发布与编辑时间（UTC）、得分（赞减踩）、评论数、分享数、赞成率、flair、外链、图片或视频时长，记录与搜索结果相同（同一 id）。 传帖子的 fullname：t3_ 加上帖子链接 reddit.com/r/<版块>/comments// 里的 ID。帖子不存在时返回 404，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:reddit", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.reddit.post/" } }, "/v1/raw/reddit/comments": { "get": { "operationId": "raw_reddit_comments", "summary": "Reddit post comments", "description": "A post's comment tree, cursor-paginated, 8 a page: a few top-level comments with the replies Reddit expands under them, flattened in Reddit's order with depth (0 for a top-level comment) and parent_cid (the comment answered): text, score, total replies, time (UTC), whether it is pinned, and the commenter. Order by best (the default), top, new, old or controversial. Replies Reddit holds back come with a replies_cursor for raw.reddit.comment_replies. Pass the previous page's cursor back to continue; stop when has_more is false. A post without comments answers empty, one that does not exist 404; neither is charged.", "tags": [ "Reddit" ], "parameters": [ { "name": "post_id", "in": "query", "required": true, "description": "The post's fullname (t3_…, extra.source_id of post detail, subreddit posts or search)", "x-qovia-description-zh": "帖子 fullname（t3_ 开头，来自帖子详情、版块帖子或搜索的 extra.source_id）", "schema": { "type": "string", "pattern": "^t3_[a-z0-9]{1,17}$", "examples": [ "t3_1xbt833" ] }, "example": "t3_1xbt833" }, { "name": "sort", "in": "query", "required": false, "description": "Order: best (the default), top, new, old or controversial", "x-qovia-description-zh": "排序：best（默认）、top 得分最高、new 最新、old 最早、controversial 争议最大", "schema": { "type": "string", "enum": [ "best", "top", "new", "old", "controversial" ], "default": "best" } }, { "name": "cursor", "in": "query", "required": false, "description": "The cursor from the previous page's response; leave it out for the first page", "x-qovia-description-zh": "取上一页响应的 cursor；第一页不传", "schema": { "type": "string", "minLength": 13, "maxLength": 2048, "pattern": "^commenttree:[!-~]+$" } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "cid": "t1_19rg000ofri4j", "text": "And the Airbnb host subreddit is having a complete meltdown about it", "likes": 4571, "reply_count": 126, "created_at": "2026-10-21T17:22:20+00:00", "pinned": false, "author": { "uid_hash": "299b37f83b60", "nickname": "example_user_1", "uid": "t2_00000001", "username": "example_user_1" }, "depth": 0, "parent_cid": null, "replies_cursor": "commenttree:53e6639b,::1:ex:,WFr2?o%Pj" }, { "cid": "t1_19rg04nkcanwl", "text": "They act like landlords instead of hospitality workers, so good. Hotels are better, people.", "likes": 3119, "reply_count": 54, "created_at": "2026-10-21T17:25:13+00:00", "pinned": false, "author": { "uid_hash": "8897faae40c1", "nickname": "example_user_2", "uid": "t2_00000002", "username": "example_user_2" }, "depth": 1, "parent_cid": "t1_19rg000ofri4j", "replies_cursor": "commenttree:aa00d618,::2:ex:,WFsK-;LP&:(:#$C8^Ag" } ], "cursor": "commenttree:b0a55329,::0:ex:,WFq4W|n.A:':HRW7A3", "has_more": true, "total": 920, "prov": { "hash": "0x0520c1630b7a5f06", "ts": "2026-10-22T03:30:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.reddit.comments", "x-qovia-title-zh": "Reddit 帖子评论", "x-qovia-description-zh": "帖子的评论树，按游标翻页，每页 8 条：几条一级评论连同 Reddit 在其下展开的回复，按 Reddit 的顺序平铺，带 depth（0 为一级评论）和 parent_cid（所回复的评论）；内容、得分、回复总数、时间（UTC）、是否置顶和评论者。 可按 best（默认）、top、new、old 或 controversial 排序。Reddit 收起的回复带 replies_cursor，交给 raw.reddit.comment_replies 获取。 把上一页返回的 cursor 传回即可翻页，has_more 为 false 时停止。帖子没有评论时返回空结果，帖子不存在时返回 404，均不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:reddit", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.reddit.comments/" } }, "/v1/raw/reddit/comment_replies": { "get": { "operationId": "raw_reddit_comment_replies", "summary": "Reddit comment replies", "description": "The replies Reddit holds back under a comment, cursor-paginated, up to 8 a page, flattened into the same tree as the comments endpoint: text, score, total replies, time (UTC), depth, parent_cid, whether it is pinned, and the replier. cursor is required: for the first page a comment's replies_cursor (from raw.reddit.comments or this endpoint), then the previous page's cursor; stop when has_more is false. A cursor Reddit does not know, or no more replies, answers empty; a post that does not exist 404; neither is charged.", "tags": [ "Reddit" ], "parameters": [ { "name": "post_id", "in": "query", "required": true, "description": "The fullname of the comment's post (t3_…)", "x-qovia-description-zh": "评论所在帖子的 fullname（t3_ 开头）", "schema": { "type": "string", "pattern": "^t3_[a-z0-9]{1,17}$", "examples": [ "t3_1xbt833" ] }, "example": "t3_1xbt833" }, { "name": "cursor", "in": "query", "required": true, "description": "A comment's replies_cursor for the first page, then the previous page's cursor", "x-qovia-description-zh": "第一页传评论的 replies_cursor，之后传上一页响应的 cursor", "schema": { "type": "string", "minLength": 13, "maxLength": 2048, "pattern": "^commenttree:[!-~]+$", "examples": [ "commenttree:1032b8a8,::1:ex:,WFs(EBkw2" ] }, "example": "commenttree:1032b8a8,::1:ex:,WFs(EBkw2" }, { "name": "sort", "in": "query", "required": false, "description": "Order: best (the default), top, new, old or controversial", "x-qovia-description-zh": "排序：best（默认）、top 得分最高、new 最新、old 最早、controversial 争议最大", "schema": { "type": "string", "enum": [ "best", "top", "new", "old", "controversial" ], "default": "best" } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "cid": "t1_19rg058wqt75s", "text": "Honestly, this is the play especially when traveling alone.", "likes": 804, "reply_count": 27, "created_at": "2026-10-21T17:25:35+00:00", "pinned": false, "author": { "uid_hash": "299b37f83b60", "nickname": "example_user_1", "uid": "t2_00000001", "username": "example_user_1" }, "depth": 1, "parent_cid": "t1_19rfzwlkafeyp", "replies_cursor": "commenttree:cd214a36,::2:ex:,WFtniC9.s" }, { "cid": "t1_19rg0qfzzddac", "text": "Even when travelling with my wife and kid. I mean not to worry about my kid spilling some drink on the bed. And have free breakfast options. Clean towels guaranteed. And generally some expected level of professionalism is just great.\n\nAirbnb is too stressful for me.", "likes": 458, "reply_count": 13, "created_at": "2026-10-21T17:38:47+00:00", "pinned": false, "author": { "uid_hash": "8897faae40c1", "nickname": "example_user_2", "uid": "t2_00000002", "username": "example_user_2" }, "depth": 2, "parent_cid": "t1_19rg058wqt75s", "replies_cursor": "commenttree:79d2a74d,::3:ex:,WFun#[H(h" } ], "cursor": "commenttree:d4377d7c,::1:ex:,WFr8~yLV1:':nEHAC\"", "has_more": true, "prov": { "hash": "0x91973e2a95a191ba", "ts": "2026-10-22T03:30:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.reddit.comment_replies", "x-qovia-title-zh": "Reddit 评论回复", "x-qovia-description-zh": "某条评论下被 Reddit 收起的回复（楼中楼），按游标翻页，每页最多 8 条，与评论接口一样平铺成树：内容、得分、回复总数、时间（UTC）、depth、parent_cid、是否置顶和回复者。 cursor 必填：第一页传评论的 replies_cursor（来自 raw.reddit.comments 或本接口），之后传上一页返回的 cursor，has_more 为 false 时停止。 cursor 无效或没有更多回复时返回空结果，帖子不存在时返回 404，均不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:reddit", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.reddit.comment_replies/" } }, "/v1/raw/reddit/subreddit_posts": { "get": { "operationId": "raw_reddit_subreddit_posts", "summary": "Reddit subreddit posts", "description": "A subreddit's posts by hot (the default), best, new, top, controversial or rising, cursor-paginated (about 6 on the first page, then about 24): title, the first 300 characters of the body, author, posted time (UTC), score, comment and share counts, flair and the link it points to, as the same records as post detail (same ids). The list carries no language, author ID, images or upvote ratio (null): raw.reddit.post does. Ads are left out. Pass the previous page's cursor back to continue; stop when has_more is false. A subreddit that does not exist answers 404 and is not charged.", "tags": [ "Reddit" ], "parameters": [ { "name": "subreddit", "in": "query", "required": true, "description": "The subreddit's name (after r/, e.g. technology)", "x-qovia-description-zh": "版块名（r/ 后面的部分，如 technology）", "schema": { "type": "string", "pattern": "^[A-Za-z0-9_]{2,21}$", "examples": [ "technology" ] }, "example": "technology" }, { "name": "sort", "in": "query", "required": false, "description": "Order: hot (the default), best, new, top, controversial or rising", "x-qovia-description-zh": "排序：hot 热门（默认）、best、new 最新、top 得分最高、controversial 争议最大、rising 上升中", "schema": { "type": "string", "enum": [ "hot", "best", "new", "top", "controversial", "rising" ], "default": "hot" } }, { "name": "cursor", "in": "query", "required": false, "description": "The cursor from the previous page's response; leave it out for the first page", "x-qovia-description-zh": "取上一页响应的 cursor；第一页不传", "schema": { "type": "string", "maxLength": 200, "pattern": "^[A-Za-z0-9+/=_-]+$" } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "id": "soc_red_21addc0593d8", "src": "social", "platform": "reddit", "lang": null, "text": "ELI5: The Earth and super massive impacts\nIn many simulations I’ve seen, a planet like object crashes into the early Earth. Part of it spins off losing mass from the impact and then it settles into orbit, eventually becoming the moon. However in other simulations of the earth today, if the moon or some other similarly-sized object approache", "author": { "uid_hash": "299b37f83b60", "followers": null, "nickname": "example_user_1", "uid": null, "username": "example_user_1" }, "metrics": { "likes": 0, "comments": 4, "shares": 0 }, "extra": { "source_id": "t3_1xbu6tq", "title": "ELI5: The Earth and super massive impacts", "subreddit": "explainlikeimfive", "subreddit_id": null, "published_at": "2026-10-21T17:51:02+00:00", "updated_at": null, "content_type": "text", "flair": "Planetary Science", "nsfw": false, "upvote_ratio": null, "link_url": null, "images": [], "cover_url": null, "video_dur_s": null, "truncated": true, "url": "https://www.reddit.com/r/explainlikeimfive/comments/1xbu6tq/" }, "prov": { "hash": "0xa0e9dd34d33942f1", "ts": "2026-10-22T03:30:00+08:00", "source": "live" } }, { "id": "soc_red_9bc3a3b081df", "src": "social", "platform": "reddit", "lang": null, "text": "ELI5: what is a fellowship in medicine?\nbonus points if you can also explain GME and ACGME ahaha but so it’s after you graduate med school? but it’s more schooling? or it’s working as a dr?", "author": { "uid_hash": "8897faae40c1", "followers": null, "nickname": "example_user_2", "uid": null, "username": "example_user_2" }, "metrics": { "likes": 17, "comments": 22, "shares": 2 }, "extra": { "source_id": "t3_1xbu413", "title": "ELI5: what is a fellowship in medicine?", "subreddit": "explainlikeimfive", "subreddit_id": null, "published_at": "2026-10-21T17:48:14+00:00", "updated_at": null, "content_type": "text", "flair": "Other", "nsfw": false, "upvote_ratio": null, "link_url": null, "images": [], "cover_url": null, "video_dur_s": null, "truncated": false, "url": "https://www.reddit.com/r/explainlikeimfive/comments/1xbu413/" }, "prov": { "hash": "0x1a80b263f0656360", "ts": "2026-10-22T03:30:00+08:00", "source": "live" } } ], "cursor": "dDNfMXhicnFoMg==", "has_more": true, "prov": { "hash": "0xc85a89bc5b7f14e3", "ts": "2026-10-22T03:30:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.reddit.subreddit_posts", "x-qovia-title-zh": "Reddit 版块帖子", "x-qovia-description-zh": "一个版块（subreddit）的帖子，按 hot（默认）、best、new、top、controversial 或 rising 排序，按游标翻页（第一页约 6 条，之后约 24 条）：标题、正文前 300 字、作者、发布时间（UTC）、得分、评论数、分享数、flair 和外链，记录与帖子详情相同（同一 id）。 列表不带语言、作者 ID、图片和赞成率（为 null），需要时用 raw.reddit.post。广告不计入。把上一页返回的 cursor 传回即可翻页，has_more 为 false 时停止。版块不存在时返回 404，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:reddit", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.reddit.subreddit_posts/" } }, "/v1/raw/reddit/user": { "get": { "operationId": "raw_reddit_user", "summary": "Reddit user profile", "description": "A Reddit user's profile: display name, karma (total, from posts and from comments), post and comment counts, whether it is verified, a brand account or a Reddit employee, account creation time (UTC), bio, links listed on the profile and avatar. Pass the username (from reddit.com/user/, without u/). This route does not show follower counts (null). A user that does not exist answers 404 and is not charged.", "tags": [ "Reddit" ], "parameters": [ { "name": "username", "in": "query", "required": true, "description": "The username (from reddit.com/user/, without u/)", "x-qovia-description-zh": "用户名（主页链接 reddit.com/user/<用户名> 里的部分，不带 u/）", "schema": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,20}$", "examples": [ "nasa" ] }, "example": "nasa" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "uid_hash": "649c1eb1827c", "platform": "reddit", "uid": "t2_1dkvvygb", "username": "nasa", "nickname": "NASA", "followers": null, "karma": 429798, "post_karma": 259891, "comment_karma": 169907, "posts": 914, "comments": 5923, "verified": true, "is_brand": true, "is_employee": false, "nsfw": false, "created_at": "2018-05-15T21:25:14+00:00", "signature": "Explore the universe and discover our home planet with NASA. \n\nVerification: nasa.gov/socialmedia", "links": [ { "title": "NASA.gov", "url": "https://nasa.gov" }, { "title": "NASA", "url": "https://twitter.com/NASA" }, { "title": "NASA", "url": "https://instagram.com/NASA" }, { "title": "NASA", "url": "https://www.facebook.com/NASA/" }, { "title": "NASA", "url": "https://twitch.tv/NASA" } ], "avatar_url": "https://styles.redditmedia.com/t5_k5gc6/styles/profileIcon_ydyqarnwt7s91.png?width=256&height=256&frame=1&auto=webp&crop=256:256,smart&s=77a410a48a906e94c2c113eafe0299c9bccd6d27", "url": "https://www.reddit.com/user/nasa/", "prov": { "hash": "0xfe79527b68583b1f", "ts": "2026-10-22T03:30:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.reddit.user", "x-qovia-title-zh": "Reddit 用户资料", "x-qovia-description-zh": "Reddit 用户主页资料：显示名、karma（总计、来自发帖与来自评论）、发帖数与评论数、是否认证、是否品牌账号、是否 Reddit 员工、注册时间（UTC）、简介、主页列出的链接和头像。 传用户名（主页链接 reddit.com/user/<用户名> 里的部分，不带 u/）。Reddit 此接口不公开粉丝数（为 null）。用户不存在时返回 404，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:reddit", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.reddit.user/" } }, "/v1/raw/reddit/search": { "get": { "operationId": "raw_reddit_search", "summary": "Reddit post search", "description": "Search Reddit posts by keyword, as the same records as post detail (same ids), about 7 a page. Order by relevance (the default), hot, top, new or comments, and limit the posting time with time_range; Reddit's search syntax works (AND, OR, NOT, quoted phrases, subreddit:, author:, title:, ...). When Reddit spell-corrects the query, corrected_query is what it searched instead. Pass the previous page's cursor back to continue; stop when has_more is false. No results answers empty and is not charged.", "tags": [ "Reddit" ], "parameters": [ { "name": "keyword", "in": "query", "required": true, "description": "Search keyword; Reddit's search syntax works", "x-qovia-description-zh": "搜索关键词，支持 Reddit 搜索语法", "schema": { "type": "string", "minLength": 1, "maxLength": 200, "pattern": "\\S", "examples": [ "openai" ] }, "example": "openai" }, { "name": "sort", "in": "query", "required": false, "description": "Order: relevance (the default), hot, top, new or comments (most commented)", "x-qovia-description-zh": "排序：relevance 相关度（默认）、hot 热门、top 得分最高、new 最新、comments 评论最多", "schema": { "type": "string", "enum": [ "relevance", "hot", "top", "new", "comments" ], "default": "relevance" } }, { "name": "time_range", "in": "query", "required": false, "description": "Posting time: all (the default), year, month, week, day or hour", "x-qovia-description-zh": "发布时间范围：all 不限（默认）、year、month、week、day、hour", "schema": { "type": "string", "enum": [ "all", "year", "month", "week", "day", "hour" ], "default": "all" } }, { "name": "cursor", "in": "query", "required": false, "description": "The cursor from the previous page's response; leave it out for the first page", "x-qovia-description-zh": "取上一页响应的 cursor；第一页不传", "schema": { "type": "string", "maxLength": 2048, "pattern": "^[A-Za-z0-9+/=_-]+$" } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "id": "soc_red_b3f859ab515a", "src": "social", "platform": "reddit", "lang": "en", "text": "Terence Tao explaining why it was extremely rude to dump these math solutions.\nI recommend watching the whole interview, but for me, the most puzzling part was why they wanted OpenAI to stay away. He actually explains it quite reasonably (6:17 to 9:12)", "author": { "uid_hash": "299b37f83b60", "followers": null, "nickname": "example_user_1", "uid": "t2_00000001", "username": "example_user_1" }, "metrics": { "likes": 150, "comments": 569, "shares": null }, "extra": { "source_id": "t3_1x7r549", "title": "Terence Tao explaining why it was extremely rude to dump these math solutions.", "subreddit": "OpenAI", "subreddit_id": "t5_3b9u5", "published_at": "2026-10-16T20:30:14+00:00", "updated_at": null, "content_type": "video", "flair": "Discussion", "nsfw": false, "upvote_ratio": 0.7206, "link_url": "https://youtu.be/bAnwMdfcMVw?si=DOnS2hNZSxF5cYaR&t=376", "images": [], "cover_url": "https://external-preview.redd.it/V9kvyCU7sgbx8ZGBcJydsg1oNb3bYE8fFN7FfE93Z1k.jpeg?format=pjpg&auto=webp&s=5f07e63001e93eaa9d559f6f9d22144fd6e26eed", "video_dur_s": null, "truncated": false, "url": "https://www.reddit.com/r/OpenAI/comments/1x7r549/terence_tao_explaining_why_it_was_extremely_rude/" }, "prov": { "hash": "0xaa4e5ac69f9f97be", "ts": "2026-10-22T03:30:00+08:00", "source": "live" } }, { "id": "soc_red_c78ae67e4e65", "src": "social", "platform": "reddit", "lang": "en", "text": "Mathematicians say OpenAI doesn't understand its own Navier-Stokes proof", "author": { "uid_hash": "8897faae40c1", "followers": null, "nickname": "example_user_2", "uid": "t2_00000002", "username": "example_user_2" }, "metrics": { "likes": 481, "comments": 402, "shares": null }, "extra": { "source_id": "t3_1x8qcrt", "title": "Mathematicians say OpenAI doesn't understand its own Navier-Stokes proof", "subreddit": "NowInTech", "subreddit_id": "t5_exd20i", "published_at": "2026-10-18T01:08:55+00:00", "updated_at": null, "content_type": "link", "flair": null, "nsfw": false, "upvote_ratio": 0.9429, "link_url": "https://the-decoder.com/mathematicians-say-openai-doesnt-understand-its-own-navier-stokes-proof/", "images": [], "cover_url": "https://external-preview.redd.it/SmEm4MEmuPMZ3tP0wC3r-FI5bo2xsQycBod_1jtAhOQ.png?auto=webp&s=2323ad854e5006feae3b301f5f7ee153440ee355", "video_dur_s": null, "truncated": false, "url": "https://www.reddit.com/r/NowInTech/comments/1x8qcrt/mathematicians_say_openai_doesnt_understand_its/" }, "prov": { "hash": "0x269c9a816aae8ad2", "ts": "2026-10-22T03:30:00+08:00", "source": "live" } } ], "cursor": "eyJjYW5kaWRhdGVzX3JldHVybmVkIjoie1wic2VjdGlvbl8xX3BpcGVsaW5lXzBfZ2xvYmFsX21vZGlmaWVyc1wiOlwiMVwiLFwic2VjdGlvbl8xX3BpcGVsaW5lXzFfbG9jYWxfbW9kaWZpZXJzXCI6XCIyXCIsXCJzZWN0aW9uXzJfcGlwZWxpbmVfOF9keW5hbWljXzBfcG9zdF9zZWFyY2hcIjpcIjdcIn0iLCJleHBlcmllbmNlX3NlbGVjdGlvbiI6InBvc3RzX3YyIiwiZXhwZXJpZW5jZV92ZXJzaW9uIjoiZGVmYXVsdCIsInNlY3Rpb25fMl9waXBlbGluZV84X2R5bmFtaWNfMF9wb3N0X3NlYXJjaCI6IjcifQ==", "has_more": true, "corrected_query": null, "prov": { "hash": "0xa32f01d9964b254a", "ts": "2026-10-22T03:30:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.reddit.search", "x-qovia-title-zh": "Reddit 帖子搜索", "x-qovia-description-zh": "按关键词搜索 Reddit 帖子，记录与帖子详情相同（同一 id），每页约 7 条。可按 relevance（默认）、hot、top、new 或 comments 排序，用 time_range 限定发布时间；支持 Reddit 的搜索语法（AND、OR、NOT、引号短语、subreddit:、author:、title: 等）。 Reddit 自动纠错时，corrected_query 是它实际搜索的词。把上一页返回的 cursor 传回即可翻页，has_more 为 false 时停止。没有结果时返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:reddit", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.reddit.search/" } }, "/v1/raw/weibo/post": { "get": { "operationId": "raw_weibo_post", "summary": "Weibo post detail", "description": "One Weibo post: full text (long posts too), author, like / comment / repost counts, reads and video plays (when Weibo shows them), topics, images, video duration, publish time, the reposted original and link. Pass the mid or the mblogid from the post's link. A post that does not exist or was deleted answers 404 and is not charged.", "tags": [ "Weibo" ], "parameters": [ { "name": "post_id", "in": "query", "required": true, "description": "The post's mid (16 digits), or the mblogid from its link weibo.com//", "x-qovia-description-zh": "微博 mid（16 位数字），或微博链接 weibo.com// 里的 mblogid", "schema": { "type": "string", "pattern": "^(?:[0-9]{15,19}|(?=[0-9]*[A-Za-z])[0-9A-Za-z]{8,10})$", "examples": [ "5356598172060958" ] }, "example": "5356598172060958" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "id": "soc_wei_f1213581dc20", "src": "social", "platform": "weibo", "lang": "zh-CN", "text": "【#你好，明天#｜长征有答案，奋进无止境】中国工农红军长征胜利90周年之际，重磅微视频《长征答案》发布。长征的答案，藏在雪山草地的脚印里，更写在今天安稳的日子里。九十载光阴流转，万水千山已过，但奋进的号角从未停歇。先辈踏开生路，我辈接续奔赴。向前，继续向前，走好新时代的长征路！#长征胜利90年了# http://t.cn/AXjvj4n5", "author": { "uid_hash": "e8f64c406208", "followers": 158106483, "nickname": "人民日报", "uid": "2803301701" }, "metrics": { "likes": 163, "comments": 73, "shares": 40, "plays": 7173811, "views": 126013 }, "extra": { "source_id": "5356598172060958", "mblogid": "RnKnn8E9g", "published_at": "2026-10-21T23:19:48+08:00", "content_type": "video", "topic": "#你好，明天", "topics": [ "你好，明天", "长征胜利90年了" ], "images": [], "cover_url": "https://wx1.sinaimg.cn/orj480/0033ImPzly1ii981zb1frj61hc0u0u0x02.jpg", "video_dur_s": 140, "ip_location": null, "truncated": false, "repost_of": null, "url": "https://weibo.com/2803301701/RnKnn8E9g" }, "prov": { "hash": "0xcc2cb8ebe79d9c1b", "ts": "2026-10-21T23:50:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.weibo.post", "x-qovia-title-zh": "微博详情", "x-qovia-description-zh": "单条微博：全文（长微博也是全文）、作者、点赞/评论/转发数、阅读数和视频播放量（微博展示时）、话题、图片、视频时长、发布时间、被转发的原微博和链接。 传 mid 或链接里的 mblogid 均可。微博不存在或已删除时返回 404，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:weibo", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.weibo.post/" } }, "/v1/raw/weibo/comments": { "get": { "operationId": "raw_weibo_comments", "summary": "Weibo post comments", "description": "First-level comments of a post (hottest first), cursor-paginated, up to 20 a page: text, likes, reply count, IP region, time, whether the poster liked it, and the commenter. Pass the previous page's cursor back to continue; stop when has_more is false. Replies come from raw.weibo.comment_replies. A post without comments, or one that does not exist, answers empty and is not charged.", "tags": [ "Weibo" ], "parameters": [ { "name": "post_id", "in": "query", "required": true, "description": "The post's mid (16 digits, a post record's extra.source_id)", "x-qovia-description-zh": "微博 mid（16 位数字，见微博记录的 extra.source_id）", "schema": { "type": "string", "pattern": "^[0-9]{15,19}$", "examples": [ "5356532793082377" ] }, "example": "5356532793082377" }, { "name": "cursor", "in": "query", "required": false, "description": "The cursor from the previous page's response; leave it out for the first page", "x-qovia-description-zh": "取上一页响应的 cursor；第一页不传", "schema": { "type": "integer", "minimum": 1 } }, { "name": "count", "in": "query", "required": false, "description": "Items per page", "x-qovia-description-zh": "每页条数", "schema": { "type": "integer", "minimum": 1, "maximum": 20, "default": 20 } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "cid": "5356596773519788", "text": "#致敬伟大的长征#，在新的长征路上继续奋勇前进！#红军长征胜利90周年#", "likes": 247, "ip_location": "中国香港", "reply_count": 59, "created_at": "2026-10-21T23:14:13+08:00", "liked_by_author": false, "author": { "uid_hash": "c2996c06401f", "nickname": "叶***", "uid": "7000000001" } }, { "cid": "5356537552833787", "text": "弘扬伟大长征精神，走好新时代的长征路！", "likes": 260, "ip_location": "四川", "reply_count": 4, "created_at": "2026-10-21T19:18:55+08:00", "liked_by_author": false, "author": { "uid_hash": "a7f13caff774", "nickname": "J***名", "uid": "7000000002" } } ], "cursor": 142331504458211, "has_more": true, "total": 1948, "prov": { "hash": "0xc6f4d4c484c07691", "ts": "2026-10-21T23:50:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.weibo.comments", "x-qovia-title-zh": "微博评论", "x-qovia-description-zh": "微博的一级评论（按热度），按游标翻页，每页最多 20 条：评论内容、点赞数、回复数、IP 属地、时间、是否被博主赞过和评论者。 把上一页返回的 cursor 传回即可翻页，has_more 为 false 时停止。回复用 raw.weibo.comment_replies 获取。没有评论或微博不存在时返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:weibo", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.weibo.comments/" } }, "/v1/raw/weibo/comment_replies": { "get": { "operationId": "raw_weibo_comment_replies", "summary": "Weibo comment replies", "description": "Replies under one comment, cursor-paginated, up to 20 a page: text, likes, IP region, time, the reply it answers, and the replier. Pass the previous page's cursor back to continue; stop when has_more is false. A later page can come back empty once: ask again. A comment without replies answers empty and is not charged.", "tags": [ "Weibo" ], "parameters": [ { "name": "comment_id", "in": "query", "required": true, "description": "The first-level comment's cid (from the post comments endpoint)", "x-qovia-description-zh": "一级评论的 cid（来自微博评论接口）", "schema": { "type": "string", "pattern": "^[0-9]{15,19}$", "examples": [ "5356596773519788" ] }, "example": "5356596773519788" }, { "name": "cursor", "in": "query", "required": false, "description": "The cursor from the previous page's response; leave it out for the first page", "x-qovia-description-zh": "取上一页响应的 cursor；第一页不传", "schema": { "type": "integer", "minimum": 1 } }, { "name": "count", "in": "query", "required": false, "description": "Items per page", "x-qovia-description-zh": "每页条数", "schema": { "type": "integer", "minimum": 1, "maximum": 20, "default": 20 } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "cid": "5356597190854849", "text": "致敬先烈！弘扬伟大长征精神，走好新时代的长征路！", "likes": 80, "ip_location": "重庆", "reply_count": null, "created_at": "2026-10-21T23:15:54+08:00", "author": { "uid_hash": "44e48150ce1f", "nickname": "静***C", "uid": "7000000003" }, "parent_cid": "5356596773519788", "reply_to_cid": null }, { "cid": "5356597278674358", "text": "在新的长征路上继续奋勇前进！", "likes": 70, "ip_location": "湖南", "reply_count": null, "created_at": "2026-10-21T23:16:15+08:00", "author": { "uid_hash": "8375a9d8d255", "nickname": "小***耶", "uid": "7000000004" }, "parent_cid": "5356596773519788", "reply_to_cid": null } ], "cursor": 140269923879621, "has_more": true, "total": 59, "prov": { "hash": "0xf6ceace4ba8ba5d8", "ts": "2026-10-21T23:50:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.weibo.comment_replies", "x-qovia-title-zh": "微博评论回复", "x-qovia-description-zh": "某条评论下的回复（楼中楼），按游标翻页，每页最多 20 条：回复内容、点赞数、IP 属地、时间、回复对象和回复者。 把上一页返回的 cursor 传回即可翻页，has_more 为 false 时停止；偶尔某页会先返回空结果，重试一次即可。没有回复时返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:weibo", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.weibo.comment_replies/" } }, "/v1/raw/weibo/user": { "get": { "operationId": "raw_weibo_user", "summary": "Weibo user profile", "description": "A Weibo user's profile with followers, following, post count, likes received, verification, bio, gender, location, personal domain and avatar. Pass either the uid or the personal domain (weibo.com/). A user that does not exist answers 404 and is not charged. Some parameters depend on each other; see x-qovia-params-schema.", "tags": [ "Weibo" ], "parameters": [ { "name": "uid", "in": "query", "required": false, "description": "The user's uid (the number in weibo.com/u/); pass this or domain", "x-qovia-description-zh": "用户 uid（主页链接 weibo.com/u/ 里的数字）；与 domain 二选一", "schema": { "type": "string", "pattern": "^[0-9]{4,12}$", "examples": [ "2803301701" ] }, "example": "2803301701" }, { "name": "domain", "in": "query", "required": false, "description": "The personal domain (from weibo.com/, e.g. rmrb); pass this or uid", "x-qovia-description-zh": "个性域名（主页链接 weibo.com/<域名> 里的部分，如 rmrb）；与 uid 二选一", "schema": { "type": "string", "pattern": "^(?=.*[A-Za-z])[A-Za-z0-9_-]{2,30}$" } } ], "x-qovia-params-schema": { "type": "object", "additionalProperties": false, "properties": { "uid": { "type": "string", "pattern": "^[0-9]{4,12}$", "description": "The user's uid (the number in weibo.com/u/); pass this or domain", "x-qovia-description-zh": "用户 uid（主页链接 weibo.com/u/ 里的数字）；与 domain 二选一", "examples": [ "2803301701" ] }, "domain": { "type": "string", "pattern": "^(?=.*[A-Za-z])[A-Za-z0-9_-]{2,30}$", "description": "The personal domain (from weibo.com/, e.g. rmrb); pass this or uid", "x-qovia-description-zh": "个性域名（主页链接 weibo.com/<域名> 里的部分，如 rmrb）；与 uid 二选一" } }, "oneOf": [ { "required": [ "uid" ] }, { "required": [ "domain" ] } ] }, "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "uid_hash": "e8f64c406208", "nickname": "人民日报", "followers": 158106478, "total_likes": 2531733928, "posts": 154474, "verified": true, "platform": "weibo", "uid": "2803301701", "domain": "rmrb", "following": 3096, "signature": "人民日报法人微博。参与、沟通、记录时代。", "verify_reason": "《人民日报》法人微博", "gender": "male", "location": "北京", "avatar_url": "https://tvax4.sinaimg.cn/crop.0.0.1018.1018.1024/0033ImPzly8h8vgemh8kxj60sa0sadgw02.jpg?KID=imgbed,tva&Expires=1792608291&ssig=BIwm2KCi85", "url": "https://weibo.com/u/2803301701", "prov": { "hash": "0xa8daf0ca01f528cb", "ts": "2026-10-21T23:50:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.weibo.user", "x-qovia-title-zh": "微博用户资料", "x-qovia-description-zh": "微博用户主页资料：粉丝、关注、微博数、累计获赞、认证信息、简介、性别、所在地、个性域名和头像。传 uid 或个性域名（weibo.com/<域名>）其中一个。 用户不存在时返回 404，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:weibo", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.weibo.user/" } }, "/v1/raw/weibo/user_posts": { "get": { "operationId": "raw_weibo_user_posts", "summary": "Weibo user posts", "description": "Posts a user published, the pinned one first, then newest first, about 20 a page, as the same records as post detail (same ids); long posts carry their start only (extra.truncated is true; raw.weibo.post gives the full text). Page by number; stop when has_more is false. A user without posts answers empty and one that does not exist answers 404; neither is charged.", "tags": [ "Weibo" ], "parameters": [ { "name": "uid", "in": "query", "required": true, "description": "The user's uid (the number in weibo.com/u/)", "x-qovia-description-zh": "用户 uid（主页链接 weibo.com/u/ 里的数字）", "schema": { "type": "string", "pattern": "^[0-9]{4,12}$", "examples": [ "2803301701" ] }, "example": "2803301701" }, { "name": "page", "in": "query", "required": false, "description": "Page number, from 1", "x-qovia-description-zh": "页码，从 1 开始", "schema": { "type": "integer", "minimum": 1, "maximum": 1000, "default": 1 } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "id": "soc_wei_5c54e4ac5cf1", "src": "social", "platform": "weibo", "lang": "zh-CN", "text": "【此刻，发条微博，#致敬伟大的长征#】#红星永远闪耀# 1934年10月至1936年10月，英雄的红军将士历时2年，纵横十余省，长驱数万里，战胜千难万险，胜利完成震撼世界、彪炳史册的长征，创造了气吞山河的人间奇迹。纪念#红军长征胜利90周年#，弘扬伟大长征精神，走好新时代的长征路！http://t.cn/AXj7rnhT", "author": { "uid_hash": "e8f64c406208", "followers": null, "nickname": "人民日报", "uid": "2803301701" }, "metrics": { "likes": 9575, "comments": 1933, "shares": 100378, "plays": 1818091 }, "extra": { "source_id": "5356532793082377", "mblogid": "RnIFVcVRL", "published_at": "2026-10-21T19:00:00+08:00", "content_type": "video", "topic": "#致敬伟大的长征", "topics": [ "致敬伟大的长征", "红星永远闪耀", "红军长征胜利90周年" ], "images": [], "cover_url": "https://wx2.sinaimg.cn/orj480/0033ImPzly1iia5k2uy7nj60ti13dx6p02.jpg", "video_dur_s": 19, "ip_location": null, "truncated": false, "repost_of": null, "url": "https://weibo.com/2803301701/RnIFVcVRL", "pinned": true }, "prov": { "hash": "0x844ced11fd673fa7", "ts": "2026-10-21T23:50:00+08:00", "source": "live" } }, { "id": "soc_wei_56162b915c95", "src": "social", "platform": "weibo", "lang": "zh-CN", "text": "【上新！#故宫的秋天太出片了#】几枝丹柿，一泓疏影，半阙清秋。#故宫秋日进度条已过半# @故宫博物院", "author": { "uid_hash": "e8f64c406208", "followers": null, "nickname": "人民日报", "uid": "2803301701" }, "metrics": { "likes": 1332, "comments": 364, "shares": 436 }, "extra": { "source_id": "5356505786222549", "mblogid": "RnHYmq6LH", "published_at": "2026-10-21T17:12:41+08:00", "content_type": "image_post", "topic": "#故宫的秋天太出片了", "topics": [ "故宫的秋天太出片了", "故宫秋日进度条已过半" ], "images": [ "https://wx1.sinaimg.cn/large/0033ImPzly1iia3accwbrj60j60y34eo02.jpg", "https://wx3.sinaimg.cn/large/0033ImPzly1iia3ac8imtj60j60y37dy02.jpg", "https://wx2.sinaimg.cn/large/0033ImPzly1iia3acci42j60j60y3k5p02.jpg", "https://wx4.sinaimg.cn/large/0033ImPzly1iia3acd7xlj60j60y3ao302.jpg", "https://wx4.sinaimg.cn/large/0033ImPzly1iia3ac4huzj60j60y3gtn02.jpg", "https://wx4.sinaimg.cn/large/0033ImPzly1iia3ac9appj60j60y37fc02.jpg", "https://wx3.sinaimg.cn/large/0033ImPzly1iia3acb1mtj60j60y3gxl02.jpg", "https://wx3.sinaimg.cn/large/0033ImPzly1iia3ac9zt2j60j60y3k2i02.jpg", "https://wx4.sinaimg.cn/large/0033ImPzly1iia3acbc6ej60j60y3qfj02.jpg" ], "cover_url": "https://wx1.sinaimg.cn/large/0033ImPzly1iia3accwbrj60j60y34eo02.jpg", "video_dur_s": null, "ip_location": null, "truncated": false, "repost_of": null, "url": "https://weibo.com/2803301701/RnHYmq6LH", "pinned": false }, "prov": { "hash": "0xe8db8e61c34824ca", "ts": "2026-10-21T23:50:00+08:00", "source": "live" } } ], "page": 1, "has_more": true, "prov": { "hash": "0x6db3a73c2ace917b", "ts": "2026-10-21T23:50:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.weibo.user_posts", "x-qovia-title-zh": "微博用户发布列表", "x-qovia-description-zh": "一个用户发布的微博，置顶在前，其余从新到旧，每页约 20 条，记录与微博详情相同（同一 id）；长微博只有开头（extra.truncated 为 true，全文用 raw.weibo.post 获取）。 按 page 翻页，has_more 为 false 时停止。没有微博时返回空结果，用户不存在时返回 404，均不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:weibo", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.weibo.user_posts/" } }, "/v1/raw/weibo/search": { "get": { "operationId": "raw_weibo_search", "summary": "Weibo search", "description": "Keyword search for Weibo posts, optionally within a range of publish dates (Beijing time, whole days), only hot, original, verified-user, media or viewpoint posts, or only posts with images, videos, music or links; the same records as post detail (same ids), with text that may be cut (extra.truncated) and no interaction counts. Pages hold a varying number of posts (up to about 20); page by number, up to 50 pages, and stop at an empty page. No results answers empty and is not charged. Some parameters depend on each other; see x-qovia-params-schema.", "tags": [ "Weibo" ], "parameters": [ { "name": "keyword", "in": "query", "required": true, "description": "Search keyword", "x-qovia-description-zh": "搜索关键词", "schema": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "\\S", "examples": [ "长征" ] }, "example": "长征" }, { "name": "start_date", "in": "query", "required": false, "description": "First publish date, included (Beijing time, YYYY-MM-DD); pass it with end_date", "x-qovia-description-zh": "发布日期起（含当天，北京时间，YYYY-MM-DD）；与 end_date 一起传", "schema": { "type": "string", "pattern": "^20[0-9]{2}-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])$", "examples": [ "2026-10-20" ] }, "example": "2026-10-20" }, { "name": "end_date", "in": "query", "required": false, "description": "Last publish date, included (Beijing time, YYYY-MM-DD); pass it with start_date", "x-qovia-description-zh": "发布日期止（含当天，北京时间，YYYY-MM-DD）；与 start_date 一起传", "schema": { "type": "string", "pattern": "^20[0-9]{2}-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])$", "examples": [ "2026-10-21" ] }, "example": "2026-10-21" }, { "name": "type", "in": "query", "required": false, "description": "Only: all, hot, original, verified (verified users), media or viewpoint; all when left out", "x-qovia-description-zh": "只看：all 全部、hot 热门、original 原创、verified 认证用户、media 媒体、viewpoint 观点；不传为全部", "schema": { "type": "string", "enum": [ "all", "hot", "original", "verified", "media", "viewpoint" ] } }, { "name": "contains", "in": "query", "required": false, "description": "Containing: all, image, video, music or link; all when left out", "x-qovia-description-zh": "包含：all 不限、image 图片、video 视频、music 音乐、link 链接；不传为不限", "schema": { "type": "string", "enum": [ "all", "image", "video", "music", "link" ] } }, { "name": "page", "in": "query", "required": false, "description": "Page number, from 1, at most 50", "x-qovia-description-zh": "页码，从 1 开始，最大 50", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1 } } ], "x-qovia-params-schema": { "type": "object", "required": [ "keyword" ], "additionalProperties": false, "properties": { "keyword": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "\\S", "description": "Search keyword", "x-qovia-description-zh": "搜索关键词", "examples": [ "长征" ] }, "start_date": { "type": "string", "pattern": "^20[0-9]{2}-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])$", "description": "First publish date, included (Beijing time, YYYY-MM-DD); pass it with end_date", "x-qovia-description-zh": "发布日期起（含当天，北京时间，YYYY-MM-DD）；与 end_date 一起传", "examples": [ "2026-10-20" ] }, "end_date": { "type": "string", "pattern": "^20[0-9]{2}-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])$", "description": "Last publish date, included (Beijing time, YYYY-MM-DD); pass it with start_date", "x-qovia-description-zh": "发布日期止（含当天，北京时间，YYYY-MM-DD）；与 start_date 一起传", "examples": [ "2026-10-21" ] }, "type": { "type": "string", "enum": [ "all", "hot", "original", "verified", "media", "viewpoint" ], "description": "Only: all, hot, original, verified (verified users), media or viewpoint; all when left out", "x-qovia-description-zh": "只看：all 全部、hot 热门、original 原创、verified 认证用户、media 媒体、viewpoint 观点；不传为全部" }, "contains": { "type": "string", "enum": [ "all", "image", "video", "music", "link" ], "description": "Containing: all, image, video, music or link; all when left out", "x-qovia-description-zh": "包含：all 不限、image 图片、video 视频、music 音乐、link 链接；不传为不限" }, "page": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1, "description": "Page number, from 1, at most 50", "x-qovia-description-zh": "页码，从 1 开始，最大 50" } }, "dependentRequired": { "start_date": [ "end_date" ], "end_date": [ "start_date" ] } }, "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "id": "soc_wei_66be530dfcd9", "src": "social", "platform": "weibo", "lang": "zh-CN", "text": "【#活动散场后男子吹响冲锋号全场沸腾#】近日，天津一场长征胜利90周年纪念活动散场后，一名男子吹响冲锋号，瞬间全场沸腾。该男子接受中新网采访时表示，当时散场后大家说再吹一个，于是就贴合主题吹了冲锋号。中国新闻网的微博视频（中国新闻网）", "author": { "uid_hash": "f879ebcea33e", "followers": null, "nickname": "工人日报", "uid": "3840768703" }, "metrics": { "likes": null, "comments": null, "shares": null }, "extra": { "source_id": "5356593191060572", "mblogid": "RnKfl4rU0", "published_at": "2026-10-21T23:00:00+08:00", "content_type": "video", "topic": "#活动散场后男子吹响冲锋号全场沸腾", "topics": [ "活动散场后男子吹响冲锋号全场沸腾" ], "images": [], "cover_url": null, "video_dur_s": null, "ip_location": null, "truncated": false, "repost_of": null, "url": "https://weibo.com/3840768703/RnKfl4rU0" }, "prov": { "hash": "0xdc59f6580c0f1192", "ts": "2026-10-21T23:50:00+08:00", "source": "live" } }, { "id": "soc_wei_efafe027096e", "src": "social", "platform": "weibo", "lang": "zh-CN", "text": "#晚安，广西！#【#周深献唱纪念红军长征胜利90周年MV#】九十年长风不息，烽烟虽远，星火滚烫。@卡布叻_周深倾情演唱的《万里长风》，以歌声回望来路，循先辈足迹，奔赴属于我们的新征程。#跨越90年的回信#（来源：央视新闻）央视新闻的微博视频", "author": { "uid_hash": "8a692ede06c2", "followers": null, "nickname": "广西新闻网", "uid": "1986954045" }, "metrics": { "likes": null, "comments": null, "shares": null }, "extra": { "source_id": "5356593190540232", "mblogid": "RnKfl2gxq", "published_at": "2026-10-21T23:00:00+08:00", "content_type": "video", "topic": "#晚安，广西！", "topics": [ "晚安，广西！", "周深献唱纪念红军长征胜利90周年MV", "跨越90年的回信" ], "images": [], "cover_url": null, "video_dur_s": null, "ip_location": null, "truncated": false, "repost_of": null, "url": "https://weibo.com/1986954045/RnKfl2gxq" }, "prov": { "hash": "0xd5cc0da71c4fbd32", "ts": "2026-10-21T23:50:00+08:00", "source": "live" } } ], "page": 1, "has_more": true, "prov": { "hash": "0x0454d79596c740cd", "ts": "2026-10-21T23:50:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.weibo.search", "x-qovia-title-zh": "微博搜索", "x-qovia-description-zh": "按关键词搜索微博，可限定发布日期范围（北京时间，按天），可只看热门、原创、认证用户、媒体或观点，可只看含图片、视频、音乐或链接的微博；记录与微博详情相同（同一 id），正文可能被截断（extra.truncated），互动数不提供。 每页条数不固定（最多约 20 条），按 page 翻页，最多 50 页，返回空结果时停止。没有结果时返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:weibo", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.weibo.search/" } }, "/v1/raw/weibo/hot_search": { "get": { "operationId": "raw_weibo_hot_search", "summary": "Weibo hot search", "description": "Weibo's realtime hot search board in rank order: the term, its heat, Weibo's label (新 new, 热 hot, 沸 boiling, 爆 exploding, ...), category, whether it is a topic, and a search link, plus the topics pinned above rank 1 (pinned). Ad slots are left out. No params; it changes about every minute.", "tags": [ "Weibo" ], "parameters": [], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "rank": 1, "word": "AG 退役", "heat": 1383391, "label": "新", "category": null, "is_topic": false, "url": "https://s.weibo.com/weibo?q=AG%20%E9%80%80%E5%BD%B9" }, { "rank": 2, "word": "红果短剧自砍摇钱树", "heat": 1284794, "label": "热", "category": null, "is_topic": false, "url": "https://s.weibo.com/weibo?q=%E7%BA%A2%E6%9E%9C%E7%9F%AD%E5%89%A7%E8%87%AA%E7%A0%8D%E6%91%87%E9%92%B1%E6%A0%91" }, { "rank": 3, "word": "他们走过二万五千里换来今天", "heat": 835614, "label": null, "category": null, "is_topic": true, "url": "https://s.weibo.com/weibo?q=%23%E4%BB%96%E4%BB%AC%E8%B5%B0%E8%BF%87%E4%BA%8C%E4%B8%87%E4%BA%94%E5%8D%83%E9%87%8C%E6%8D%A2%E6%9D%A5%E4%BB%8A%E5%A4%A9%23" }, { "rank": 4, "word": "肖战刘铮亮当群演了", "heat": 731539, "label": null, "category": "剧集", "is_topic": true, "url": "https://s.weibo.com/weibo?q=%23%E8%82%96%E6%88%98%E5%88%98%E9%93%AE%E4%BA%AE%E5%BD%93%E7%BE%A4%E6%BC%94%E4%BA%86%23" } ], "pinned": [ { "rank": null, "word": "我们的长征路", "heat": null, "label": "热", "category": null, "is_topic": true, "url": "https://s.weibo.com/weibo?q=%23%E6%88%91%E4%BB%AC%E7%9A%84%E9%95%BF%E5%BE%81%E8%B7%AF%23" } ], "prov": { "hash": "0x91b7ec5e863c022e", "ts": "2026-10-21T23:50:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.weibo.hot_search", "x-qovia-title-zh": "微博热搜榜", "x-qovia-description-zh": "微博实时热搜榜，按排名：热搜词、热度、标签（新、热、沸、爆等）、分类、是否话题和搜索链接，以及置顶在榜首之上的话题（pinned）。广告位不返回。 无需参数，约每分钟更新。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:weibo", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.weibo.hot_search/" } }, "/v1/raw/toutiao/article": { "get": { "operationId": "raw_toutiao_article", "summary": "Toutiao article detail", "description": "One Toutiao article's title, author (followers, verification), read / like / comment / share / save counts and cover. Body text and publish time are not available. A video's ID answers the same data (content_type video). An article that does not exist or was deleted answers 404 and is not charged.", "tags": [ "Toutiao" ], "parameters": [ { "name": "article_id", "in": "query", "required": true, "description": "Article ID (the number in toutiao.com/article//)", "x-qovia-description-zh": "文章 ID（文章链接 toutiao.com/article// 里的数字）", "schema": { "type": "string", "pattern": "^[0-9]{15,20}$", "examples": [ "7696832476378841640" ] }, "example": "7696832476378841640" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "id": "soc_tou_39a391897265", "src": "social", "platform": "toutiao", "lang": "zh-CN", "text": "重磅！大风暴前夜，中国要捅破这重天！这步大棋，你看懂了吗？", "author": { "uid_hash": "f5fdb2f05f9d", "followers": 4078656, "nickname": "占豪", "user_id": "4118004227", "verified": true, "verify_reason": "头条领航创作者", "avatar_url": "https://p3-sign.toutiaoimg.com/user-avatar/400f6974a38c372858b860c1d2ea2473~tplv-resize:120:120.image?_iz=112761&from=tt_user.tuwen&lk3s=06827d14&x-expires=1793232000&x-signature=yCAcsbFhOUdUpP%2FWit0Fii1jM%2B4%3D" }, "metrics": { "likes": 2298, "comments": 112, "shares": 1526, "saves": 1239, "views": 67840 }, "extra": { "source_id": "7696832476378841640", "url": "https://www.toutiao.com/article/7696832476378841640/", "title": "重磅！大风暴前夜，中国要捅破这重天！这步大棋，你看懂了吗？", "content_type": "article", "published_at": null, "video_dur_s": null, "cover_url": "https://p3-sign.toutiaoimg.com/tos-cn-i-6w9my0ksvp/0d93d29482af430eb4664fe1c46810d5~tplv-tt-thumb.webp?_iz=1&bid=10&ci=&from=article.private_chat&gi=&gid=7696832476378841640&ii=0&lk3s=06827d14&rt=0&x-expires=1793202536&x-signature=RZMDpnbD%2BJtLa%2F1L2YJV7gkSuHw%3D" }, "prov": { "hash": "0xd412fe8b17a7b899", "ts": "2026-10-22T00:00:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.toutiao.article", "x-qovia-title-zh": "今日头条文章详情", "x-qovia-description-zh": "单篇头条文章的标题、作者（粉丝数、认证信息）、阅读/点赞/评论/分享/收藏数和封面。不含正文和发布时间。 传视频的 ID 也能查到同样的数据（content_type 为 video）。文章不存在或已删除时返回 404，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:toutiao", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.toutiao.article/" } }, "/v1/raw/toutiao/video": { "get": { "operationId": "raw_toutiao_video", "summary": "Toutiao video detail", "description": "One Toutiao video: title, summary, author (followers, verification), play / like / comment / share / save counts, publish time, duration and cover. A video that does not exist or was deleted, or an article's ID, answers 404 and is not charged.", "tags": [ "Toutiao" ], "parameters": [ { "name": "video_id", "in": "query", "required": true, "description": "Video ID (the number in toutiao.com/video//)", "x-qovia-description-zh": "视频 ID（视频链接 toutiao.com/video// 里的数字）", "schema": { "type": "string", "pattern": "^[0-9]{15,20}$", "examples": [ "7698919784800420352" ] }, "example": "7698919784800420352" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "id": "soc_tou_9265ff240147", "src": "social", "platform": "toutiao", "lang": "zh-CN", "text": "北京 降雨降温 外出注意添衣保暖", "author": { "uid_hash": "e8e55902e40d", "followers": 113447603, "nickname": "央视新闻", "user_id": "4492956276", "verified": true, "verify_reason": "中央广播电视总台央视新闻官方账号", "avatar_url": "https://p3-sign.toutiaoimg.com/user-avatar/44ef8ebcb1014a36882db98edd29729a~tplv-resize:120:120.image?_iz=112761&from=tt_user.video&lk3s=06827d14&x-expires=1793232000&x-signature=asz%2FjNP0vD%2FLbdnN5de3Sopffpg%3D" }, "metrics": { "likes": 198, "comments": 1, "shares": 24, "saves": 24, "views": 39473 }, "extra": { "source_id": "7698919784800420352", "url": "https://www.toutiao.com/video/7698919784800420352/", "title": "北京 降雨降温 外出注意添衣保暖", "content_type": "video", "published_at": "2026-10-21T09:00:58+08:00", "video_dur_s": 25, "cover_url": "https://p3-sign.toutiaoimg.com/tos-cn-i-tjoges91tu/17acb236f2f0d567147b3a6b23c1b631~tplv-tt-im:1920:1440.webp?_iz=1&bid=16&ci=&from=ttvideo.private_chat&gi=&gid=7698919784800420352&ii=0&lk3s=06827d14&rt=0&x-expires=1793202528&x-signature=UNNvfr2%2FYMGNjmMOkDd3hCRcOwQ%3D" }, "prov": { "hash": "0xef008600a931f305", "ts": "2026-10-22T00:00:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.toutiao.video", "x-qovia-title-zh": "今日头条视频详情", "x-qovia-description-zh": "单个头条视频：标题、简介、作者（粉丝数、认证信息）、播放/点赞/评论/分享/收藏数、发布时间、时长和封面。 视频不存在、已删除或传入的是文章 ID 时返回 404，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:toutiao", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.toutiao.video/" } }, "/v1/raw/toutiao/comments": { "get": { "operationId": "raw_toutiao_comments", "summary": "Toutiao comments", "description": "First-level comments of an article or a video, hottest first, 20 a page: text, likes, reply count, time, IP location, whether the author liked it, and the commenter. Pass the previous page's cursor back to continue (adjacent pages may repeat a comment: deduplicate by cid); stop when has_more is false. Content without comments, or that does not exist, answers empty and is not charged.", "tags": [ "Toutiao" ], "parameters": [ { "name": "group_id", "in": "query", "required": true, "description": "Article or video ID (the number in toutiao.com/article// or toutiao.com/video//)", "x-qovia-description-zh": "文章或视频 ID（链接 toutiao.com/article// 或 toutiao.com/video// 里的数字）", "schema": { "type": "string", "pattern": "^[0-9]{15,20}$", "examples": [ "7696832476378841640" ] }, "example": "7696832476378841640" }, { "name": "cursor", "in": "query", "required": false, "description": "The cursor from the previous page's response; 0 for the first page", "x-qovia-description-zh": "取上一页响应的 cursor；第一页为 0", "schema": { "type": "integer", "minimum": 0, "maximum": 10000, "default": 0 } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "cid": "7696924554858038035", "text": "人民，只有人民，才是创造世界历史的动力。", "likes": 125, "ip_location": "云南", "reply_count": 4, "created_at": "2026-10-15T23:58:29+08:00", "liked_by_author": false, "images": [], "author": { "uid_hash": "5e4e56ddf496", "nickname": "福***V", "user_id": "4000000000000001" } }, { "cid": "7698663575212688179", "text": "@豆包 看的热血沸腾。我们的政府高瞻远瞩，未雨绸缪。我们大中华越来越繁荣昌盛！屹立于世界之巅！", "likes": 2, "ip_location": "四川", "reply_count": 1, "created_at": "2026-10-20T16:26:45+08:00", "liked_by_author": false, "images": [], "author": { "uid_hash": "08289dab4865", "nickname": "青***宛", "user_id": "4000000000000002" } } ], "cursor": 20, "has_more": true, "total": 112, "prov": { "hash": "0x42c1e69b4fcb7300", "ts": "2026-10-22T00:00:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001000", "balance_usd": "9.999000", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.toutiao.comments", "x-qovia-title-zh": "今日头条评论", "x-qovia-description-zh": "文章或视频的一级评论，按热度排序，每页 20 条：评论内容、点赞数、回复数、时间、IP 属地、是否被作者点赞和评论者。 把上一页返回的 cursor 传回即可翻页（相邻页可能有个别重复，请按 cid 去重），has_more 为 false 时停止。没有评论或内容不存在时返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:toutiao", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1000, "usd_per_call": "0.001000", "usd_per_1k": "1" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.toutiao.comments/" } }, "/v1/raw/taobao/comments": { "get": { "operationId": "raw_taobao_comments", "summary": "Taobao & Tmall product reviews", "description": "Buyer reviews of a Taobao or Tmall item, newest first, 20 per page: text and time, positive / neutral / negative rating, SKU, the buyer's nickname (masked by Taobao) and member level, photos and videos, the follow-up review and shop replies. item_id takes Taobao and Tmall item IDs alike. Default positive reviews without text are skipped unless they carry a follow-up. Stop paging when has_more is false. An item without reviews, or one that does not exist, answers empty and is not charged.", "tags": [ "Taobao & Tmall" ], "parameters": [ { "name": "item_id", "in": "query", "required": true, "description": "Taobao or Tmall item ID (the id= in the item URL)", "x-qovia-description-zh": "淘宝或天猫商品 ID（商品链接里的 id=）", "schema": { "type": "string", "pattern": "^[1-9][0-9]{5,19}$", "examples": [ "611261922146" ] }, "example": "611261922146" }, { "name": "page", "in": "query", "required": false, "description": "Page number, from 1; stop when has_more is false", "x-qovia-description-zh": "页码，从 1 开始；has_more 为 false 时停止", "schema": { "type": "integer", "minimum": 1, "maximum": 500, "default": 1 } }, { "name": "skip_default_reviews", "in": "query", "required": false, "description": "true (default) skips default positive reviews without text (those with a follow-up stay); false returns every review", "x-qovia-description-zh": "true（默认）跳过没有内容的默认好评（带追评的仍保留）；false 返回全部评价", "schema": { "type": "boolean", "default": true } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "id": "eco_tao_e35d27d45024", "cid": "1316054905552", "text": "其实线上买药很方便也很优惠很好，", "rating_level": "good", "likes": 0, "created_at": "2026-10-03T21:27:00+08:00", "sku": "套餐类型:1盒装[基础体验【欧洲原研进口】]", "user_name": "刘***7", "user_level": 0, "anonymous": true, "images": [ "https://img.alicdn.com/imgextra/i4/4611686018427385600/O1CN01bZPUiKO6BBJ1SdaC_!!4611686018427385600-0-rate.jpg_400x400.jpg" ], "videos": [], "shop_reply": null, "followup": { "text": "相信", "days_after_receipt": 16, "images": [ "https://img.alicdn.com/imgextra/i1/4611686018427385600/O1CN01L74IopdbT1I1SdaC_!!4611686018427385600-0-rate.jpg_400x400.jpg" ], "videos": [], "shop_reply": "感谢您的认可，也谢谢您的晒图和追评。能让您买药更方便、享受到实惠，我们很高兴。…" } }, { "id": "eco_tao_9b5c72573494", "cid": "1316866273768", "text": "我觉得性价比一般，有点贵。效果还可以", "rating_level": "good", "likes": 0, "created_at": "2026-10-14T21:08:00+08:00", "sku": "套餐类型:1盒装[基础体验【欧洲原研进口】]", "user_name": "欣***笑", "user_level": 0, "anonymous": false, "images": [ "https://img.alicdn.com/imgextra/i3/4611686018427380977/O1CN01mo211OzAnAF2BxNI_!!4611686018427380977-0-rate.jpg_400x400.jpg" ], "videos": [], "shop_reply": null, "followup": null } ], "page": 1, "has_more": true, "total": 400, "total_exact": false, "prov": { "hash": "0x7b921e36e8cf1b4c", "ts": "2026-10-21T19:59:04+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.013500", "balance_usd": "9.986500", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.taobao.comments", "x-qovia-title-zh": "淘宝/天猫商品评价", "x-qovia-description-zh": "淘宝和天猫商品的买家评价，从新到旧，每页 20 条：评价内容和时间、好评/中评/差评、SKU、买家昵称（平台已打码）和会员等级、晒图和视频、追评和商家回复。 item_id 填淘宝或天猫的商品 ID 均可。默认跳过没有内容的默认好评（带追评的仍保留）。 has_more 为 false 时停止翻页。商品没有评价或不存在时返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:taobao", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 13500, "usd_per_call": "0.013500", "usd_per_1k": "13.5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.taobao.comments/" } }, "/v1/raw/taobao/comments_v2": { "get": { "operationId": "raw_taobao_comments_v2", "summary": "Taobao & Tmall product reviews V2", "description": "Buyer reviews of a Taobao or Tmall item, returned as the platform answers in JSON: the comments list (20 per page, each with text and time, rating, SKU, the buyer's nickname, photos and videos, follow-up review, shop reply, likes), plus the review total, maxPage, the popular review keywords (first page only) and hasNextPage. item_id takes Taobao and Tmall item IDs alike; page starts at 1; stop paging when hasNextPage is false. It usually answers in about 3 seconds. Only an answer with data is charged; an item without reviews, or an error, is not.", "tags": [ "Taobao & Tmall" ], "parameters": [ { "name": "item_id", "in": "query", "required": true, "description": "Taobao or Tmall item ID (the id= in the item URL)", "x-qovia-description-zh": "淘宝或天猫商品 ID（商品链接里的 id=）", "schema": { "type": "string", "pattern": "^[1-9][0-9]{5,19}$", "examples": [ "611261922146" ] }, "example": "611261922146" }, { "name": "page", "in": "query", "required": false, "description": "Page number, from 1; stop when hasNextPage is false", "x-qovia-description-zh": "页码，从 1 开始；hasNextPage 为 false 时停止", "schema": { "type": "integer", "minimum": 1, "maximum": 500, "default": 1 } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "qnaDisabled": true, "watershed": 100, "total": 4000, "totalFuzzy": "4000+", "comments": [ { "date": "2026年10月31日 00:29", "shareInfo": { "lastReplyTime": "", "share": false, "pic": 0, "reply": 0, "userNumIdBase64": "" }, "showDepositIcon": false, "o2oRate": null, "mainTradeId": 0, "raterType": 0, "validscore": 1, "video": null, "photos": [], "content": "该用户觉得商品非常好，给出5星好评", "rateId": 2914289593649150, "spuRatting": [], "auction": { "thumbnail": "", "link": "//item.taobao.com/auction/item_detail.htm?item_num_id=611261922146", "auctionPic": "", "sku": "套餐类型:2盒装[疗程周期【缓解多种过敏症状】]", "title": "", "aucNumId": "611261922146" }, "award": "", "rate": "1", "creditFraudRule": 0, "appendCanExplainable": false, "from": "h5", "tag": "", "propertiesAvg": "5", "reply": null, "dayAfterConfirm": 0, "lastModifyFrom": 0, "bidPriceMoney": null, "noQna": true, "promotionType": "", "vicious": "", "enableSNS": false, "appendList": [], "buyAmount": 0, "showCuIcon": false, "serviceRate": null, "useful": 0, "likeCount": 0, "user": { "nick": "爱***娘", "vipLevel": 0, "displayRatePic": "", "nickUrl": "", "creditPic": "", "anony": true, "rank": 0, "avatar": "https://gw.alicdn.com/imgextra/i3/O1CN01YXMxVW1ng5k8sZ6L3_!!6000000005118-0-tps-160-160.jpg_Q75.jpg_.webp", "vip": "", "userId": "", "rankUrl": "" }, "append": null, "status": 0 } ], "currentPageNum": 1, "maxPage": 50, "keywords": [ { "count": "25", "labelId": "2093864846-11", "type": "1", "word": "价格便宜" }, { "count": "14", "labelId": "2030868717-11", "type": "1", "word": "使用体验很好" } ], "hasMediaCount": 100, "hasAppendCount": 17, "hasNextPage": true }, "meta": { "billed": true, "charged_usd": "0.016910", "balance_usd": "9.983090", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.taobao.comments_v2", "x-qovia-title-zh": "淘宝/天猫商品评价 V2", "x-qovia-description-zh": "淘宝和天猫商品的买家评价（按平台的原样 JSON 返回）：comments 列表（每页 20 条，含评价内容和时间、评分、SKU、买家昵称、晒图和视频、追评、商家回复、点赞数），以及评价总数 total、总页数 maxPage、热门评价词 keywords（仅第一页）和是否有下一页 hasNextPage。 item_id 填淘宝或天猫的商品 ID 均可，page 从 1 开始，hasNextPage 为 false 时停止翻页。一般 3 秒左右返回。 只对有数据的结果计费，没有评价或出错都不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:taobao", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 16910, "usd_per_call": "0.016910", "usd_per_1k": "16.91" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.taobao.comments_v2/" } }, "/v1/raw/jd/comments": { "get": { "operationId": "raw_jd_comments", "summary": "JD.com product reviews", "description": "Buyer reviews of a JD.com product, newest first, 10 per page: text and time, 1-5 star rating, variant and SKU ID, the buyer's nickname (mostly masked by JD), anonymity, IP location, full-size photos, helpful votes and the shop's reply. By default only this SKU's reviews; with only_this_sku false, every variant of the product. max_page tells how far paging goes (often far fewer pages than the review total); stop when has_more is false. A SKU without reviews, or one that does not exist, answers empty and is not charged.", "tags": [ "JD.com" ], "parameters": [ { "name": "sku_id", "in": "query", "required": true, "description": "JD.com SKU ID (the number in item.jd.com/.html)", "x-qovia-description-zh": "京东商品 SKU ID（商品链接 item.jd.com/.html 里的数字）", "schema": { "type": "string", "pattern": "^[1-9][0-9]{3,19}$", "examples": [ "100006271091" ] }, "example": "100006271091" }, { "name": "page", "in": "query", "required": false, "description": "Page number, from 1, up to the max_page of the previous answer; stop when has_more is false", "x-qovia-description-zh": "页码，从 1 开始，不超过上一页返回的 max_page；has_more 为 false 时停止", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 1 } }, { "name": "only_this_sku", "in": "query", "required": false, "description": "true (default) returns this SKU's reviews only; false returns the reviews of every variant (colour, size, ...) of the product", "x-qovia-description-zh": "true（默认）只看这个 SKU 的评价；false 返回同一商品所有规格（颜色、尺码等）的评价", "schema": { "type": "boolean", "default": true } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "id": "eco_jd_43a365a0aaef", "cid": "106314560218561793", "text": "还可以吧，唯一的缺点就是颗粒太大了，吞咽的时候有点不舒服", "rating": 5, "likes": 0, "created_at": "2026-10-20T19:45:27+08:00", "sku": "规格:【60片*1盒】院线同款-60天用量", "sku_id": "100006271091", "user_name": "j***i", "anonymous": false, "ip_location": "广东", "images": [], "shop_reply": "非常感谢您的反馈！我们注意到您对颗粒大小的反馈，这可能给您带来了些许不适。我们会努力改进产品。…" }, { "id": "eco_jd_001042af4786", "cid": "106191920223780233", "text": "一直喝的这个，每天一个，挺好的，一家人都在喝。", "rating": 5, "likes": 0, "created_at": "2026-10-18T18:55:50+08:00", "sku": "规格:【60片*1盒】院线同款-60天用量", "sku_id": "100006271091", "user_name": "赵***g", "anonymous": false, "ip_location": "河北", "images": [ "https://img30.360buyimg.com/shaidan/jfs/t1/549256/12/1897/1368430/6ad4a5b5Fc881e4a1/00a9c00000e872a7.jpg" ], "shop_reply": "嘿，看到您一直钟爱我们的善存多维元素片，真是倍感荣幸！…" } ], "page": 1, "has_more": true, "max_page": 2, "total": 20000, "prov": { "hash": "0x494e4995216cc2cc", "ts": "2026-10-21T20:03:12+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.019500", "balance_usd": "9.980500", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.jd.comments", "x-qovia-title-zh": "京东商品评价", "x-qovia-description-zh": "京东商品的买家评价，从新到旧，每页 10 条：评价内容和时间、1–5 星评分、规格和 SKU ID、买家昵称（多数已由京东打码）、匿名标记、IP 属地、晒图（原图）、有用数和商家回复。 默认只看这个 SKU 的评价，only_this_sku 为 false 时返回同一商品所有规格的评价。 可翻页数见 max_page（常远少于评价总数），has_more 为 false 时停止。没有评价或 SKU 不存在时返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:jd", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 19500, "usd_per_call": "0.019500", "usd_per_1k": "19.5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.jd.comments/" } }, "/v1/raw/shopee/product": { "get": { "operationId": "raw_shopee_product", "summary": "Shopee product detail", "description": "Title, price, rating, orders and stock across SG/TH/VN/ID/MY/PH.", "tags": [ "Shopee" ], "parameters": [ { "name": "item_id", "in": "query", "required": true, "description": "Shopee item ID (itemid)", "x-qovia-description-zh": "Shopee 商品 ID（itemid）", "schema": { "type": "string", "minLength": 1, "examples": [ "22874185231" ] }, "example": "22874185231" }, { "name": "region", "in": "query", "required": true, "description": "Marketplace: sg Singapore, th Thailand, vn Vietnam, id Indonesia, my Malaysia, ph Philippines", "x-qovia-description-zh": "站点：sg 新加坡、th 泰国、vn 越南、id 印度尼西亚、my 马来西亚、ph 菲律宾", "schema": { "type": "string", "enum": [ "sg", "th", "vn", "id", "my", "ph" ], "examples": [ "th" ] }, "example": "th" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "id": "eco_sho_1639", "src": "ecommerce", "platform": "shopee", "lang": "th-TH", "title": "หูฟังไร้สาย รุ่นใหม่ 2026", "price": { "current": 1290, "currency": "THB", "drop_7d": -12 }, "metrics": { "rating": 4.8, "orders": 2043, "reviews": 861 } }, "meta": { "billed": true, "charged_usd": "0.001500", "balance_usd": "9.998500", "empty": false } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "x-qovia-endpoint-id": "raw.shopee.product", "x-qovia-title-zh": "Shopee 商品详情", "x-qovia-description-zh": "商品标题、价格、评分、销量和库存，支持 SG/TH/VN/ID/MY/PH 站点。", "x-qovia-availability": "coming_soon", "x-qovia-status": "beta", "x-qovia-scope": "raw:shopee", "x-qovia-price": { "mode": "tiered", "unit_price_micros": 1500, "usd_per_call": "0.001500", "usd_per_1k": "1.5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.shopee.product/" } }, "/v1/raw/shopee/reviews": { "get": { "operationId": "raw_shopee_reviews", "summary": "Shopee product reviews", "description": "Product reviews, cursor-paginated.", "tags": [ "Shopee" ], "parameters": [ { "name": "item_id", "in": "query", "required": true, "description": "Shopee item ID (itemid)", "x-qovia-description-zh": "Shopee 商品 ID（itemid）", "schema": { "type": "string", "minLength": 1, "examples": [ "22874185231" ] }, "example": "22874185231" }, { "name": "region", "in": "query", "required": true, "description": "Marketplace: sg Singapore, th Thailand, vn Vietnam, id Indonesia, my Malaysia, ph Philippines", "x-qovia-description-zh": "站点：sg 新加坡、th 泰国、vn 越南、id 印度尼西亚、my 马来西亚、ph 菲律宾", "schema": { "type": "string", "enum": [ "sg", "th", "vn", "id", "my", "ph" ], "examples": [ "th" ] }, "example": "th" }, { "name": "cursor", "in": "query", "required": false, "description": "The cursor from the previous page's response", "x-qovia-description-zh": "取上一页响应的 cursor", "schema": { "type": "integer", "minimum": 0, "default": 0 } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "rid": "r_301", "rating": 5, "text": "ราคานี้คุ้มมาก รีวิวจริง" } ], "cursor": 20, "has_more": true }, "meta": { "billed": true, "charged_usd": "0.001500", "balance_usd": "9.998500", "empty": false } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "x-qovia-endpoint-id": "raw.shopee.reviews", "x-qovia-title-zh": "Shopee 商品评价", "x-qovia-description-zh": "商品评价列表，按游标翻页。", "x-qovia-availability": "coming_soon", "x-qovia-status": "beta", "x-qovia-scope": "raw:shopee", "x-qovia-price": { "mode": "tiered", "unit_price_micros": 1500, "usd_per_call": "0.001500", "usd_per_1k": "1.5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.shopee.reviews/" } }, "/v1/raw/shopee/prices": { "get": { "operationId": "raw_shopee_prices", "summary": "Shopee price history", "description": "Daily price trajectory for a product, up to 90 days.", "tags": [ "Shopee" ], "parameters": [ { "name": "item_id", "in": "query", "required": true, "description": "Shopee item ID (itemid)", "x-qovia-description-zh": "Shopee 商品 ID（itemid）", "schema": { "type": "string", "minLength": 1, "examples": [ "22874185231" ] }, "example": "22874185231" }, { "name": "region", "in": "query", "required": true, "description": "Marketplace: sg Singapore, th Thailand, vn Vietnam, id Indonesia, my Malaysia, ph Philippines", "x-qovia-description-zh": "站点：sg 新加坡、th 泰国、vn 越南、id 印度尼西亚、my 马来西亚、ph 菲律宾", "schema": { "type": "string", "enum": [ "sg", "th", "vn", "id", "my", "ph" ], "examples": [ "th" ] }, "example": "th" }, { "name": "days", "in": "query", "required": false, "description": "How many recent days of prices to return", "x-qovia-description-zh": "返回最近多少天的价格", "schema": { "type": "integer", "minimum": 1, "maximum": 90, "default": 30 } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "currency": "THB", "points": [ { "date": "2026-07-01", "price": 1470 }, { "date": "2026-07-04", "price": 1290 } ] }, "meta": { "billed": true, "charged_usd": "0.001500", "balance_usd": "9.998500", "empty": false } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "x-qovia-endpoint-id": "raw.shopee.prices", "x-qovia-title-zh": "Shopee 价格走势", "x-qovia-description-zh": "商品每日价格轨迹，最长 90 天。", "x-qovia-availability": "coming_soon", "x-qovia-status": "beta", "x-qovia-scope": "raw:shopee", "x-qovia-price": { "mode": "tiered", "unit_price_micros": 1500, "usd_per_call": "0.001500", "usd_per_1k": "1.5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.shopee.prices/" } }, "/v1/raw/amazon/product": { "get": { "operationId": "raw_amazon_product", "summary": "Amazon product detail", "description": "Title, price, rating, review count and BSR rank.", "tags": [ "Amazon" ], "parameters": [ { "name": "asin", "in": "query", "required": true, "description": "Product ASIN (10 uppercase letters or digits)", "x-qovia-description-zh": "商品 ASIN（10 位大写字母或数字）", "schema": { "type": "string", "pattern": "^[A-Z0-9]{10}$", "examples": [ "B0BDHWDR12" ] }, "example": "B0BDHWDR12" }, { "name": "marketplace", "in": "query", "required": false, "description": "Marketplace: us United States, uk United Kingdom, de Germany, jp Japan, sg Singapore", "x-qovia-description-zh": "站点：us 美国、uk 英国、de 德国、jp 日本、sg 新加坡", "schema": { "type": "string", "enum": [ "us", "uk", "de", "jp", "sg" ], "default": "us" } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "id": "eco_ama_eed1", "src": "ecommerce", "platform": "amazon", "lang": "en-US", "title": "Wireless earbuds — 2026 model", "price": { "current": 79.99, "currency": "USD", "drop_7d": -10 }, "metrics": { "rating": 4.6, "reviews": 12400, "bsr": 38 } }, "meta": { "billed": true, "charged_usd": "0.001500", "balance_usd": "9.998500", "empty": false } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "x-qovia-endpoint-id": "raw.amazon.product", "x-qovia-title-zh": "Amazon 商品详情", "x-qovia-description-zh": "商品标题、价格、评分、评论数和 BSR 排名。", "x-qovia-availability": "coming_soon", "x-qovia-status": "beta", "x-qovia-scope": "raw:amazon", "x-qovia-price": { "mode": "tiered", "unit_price_micros": 1500, "usd_per_call": "0.001500", "usd_per_1k": "1.5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.amazon.product/" } }, "/v1/raw/amazon/reviews": { "get": { "operationId": "raw_amazon_reviews", "summary": "Amazon product reviews", "description": "Product reviews, paginated.", "tags": [ "Amazon" ], "parameters": [ { "name": "asin", "in": "query", "required": true, "description": "Product ASIN (10 uppercase letters or digits)", "x-qovia-description-zh": "商品 ASIN（10 位大写字母或数字）", "schema": { "type": "string", "pattern": "^[A-Z0-9]{10}$", "examples": [ "B0BDHWDR12" ] }, "example": "B0BDHWDR12" }, { "name": "marketplace", "in": "query", "required": false, "description": "Marketplace: us United States, uk United Kingdom, de Germany, jp Japan, sg Singapore", "x-qovia-description-zh": "站点：us 美国、uk 英国、de 德国、jp 日本、sg 新加坡", "schema": { "type": "string", "enum": [ "us", "uk", "de", "jp", "sg" ], "default": "us" } }, { "name": "page", "in": "query", "required": false, "description": "Page number, from 1", "x-qovia-description-zh": "页码，从 1 开始", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1 } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "rid": "a_77", "rating": 5, "title": "Great value", "verified": true } ], "page": 1, "has_more": true }, "meta": { "billed": true, "charged_usd": "0.001500", "balance_usd": "9.998500", "empty": false } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "x-qovia-endpoint-id": "raw.amazon.reviews", "x-qovia-title-zh": "Amazon 商品评论", "x-qovia-description-zh": "商品评论列表，按页翻。", "x-qovia-availability": "coming_soon", "x-qovia-status": "beta", "x-qovia-scope": "raw:amazon", "x-qovia-price": { "mode": "tiered", "unit_price_micros": 1500, "usd_per_call": "0.001500", "usd_per_1k": "1.5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.amazon.reviews/" } }, "/v1/raw/fliggy/hotel": { "get": { "operationId": "raw_fliggy_hotel", "summary": "Fliggy hotel rating", "description": "Rating summary of a Fliggy hotel: overall score (10-point scale), review counts (total, good, bad, with photos), sub-scores (location, cleanliness, service, facilities), 1–5 star distribution and top review tags. Hotel name not included. An unknown or not-yet-rated hotel returns an empty, unbilled result.", "tags": [ "Fliggy" ], "parameters": [ { "name": "hotel_id", "in": "query", "required": true, "description": "Fliggy hotel ID (shid, 5–15 digits), e.g. 10052156", "x-qovia-description-zh": "飞猪酒店 ID（shid，5–15 位数字），例如 10052156", "schema": { "type": "string", "pattern": "^[1-9][0-9]{4,14}$", "examples": [ "10052156" ] }, "example": "10052156" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "id": "eco_fli_5c1e0a9b7f42", "src": "ecommerce", "platform": "fliggy", "lang": "zh-CN", "metrics": { "rating": 9.0, "reviews": 3277, "good_reviews": 2779, "bad_reviews": 143, "photo_reviews": 50 }, "dimensions": [ { "name": "位置便利", "score": 9.2, "count": 2929 }, { "name": "清洁程度", "score": 9.0, "count": 2929 }, { "name": "服务态度", "score": 9.2, "count": 2929 }, { "name": "设施体验", "score": 8.8, "count": 2929 } ], "distribution": [ { "stars": 5, "label": "非常棒", "count": 2319 }, { "stars": 4, "label": "值得赞", "count": 756 }, { "stars": 3, "label": "一般般", "count": 127 }, { "stars": 2, "label": "有些差", "count": 31 }, { "stars": 1, "label": "糟透了", "count": 38 } ], "tags": [ { "name": "近机场", "count": 212, "positive": true }, { "name": "服务热心", "count": 182, "positive": true }, { "name": "性价比高", "count": 103, "positive": true } ], "extra": { "source_id": "10052156", "rating_scale": 10, "rating_label": "好" }, "prov": { "hash": "0x3b9f2c07d41e8a65", "ts": "2026-10-20T12:00:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001500", "balance_usd": "9.998500", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.fliggy.hotel", "x-qovia-title-zh": "飞猪酒店评分", "x-qovia-description-zh": "飞猪酒店的评分概况：综合评分（10 分制）、评价总数、好评/差评/带图评价数、分项评分（位置、清洁、服务、设施）、 1–5 星分布和热门评价标签。不含酒店名称。酒店不存在或还没有评价时返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:fliggy", "x-qovia-price": { "mode": "tiered", "unit_price_micros": 1500, "usd_per_call": "0.001500", "usd_per_1k": "1.5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.fliggy.hotel/" } }, "/v1/raw/fliggy/reviews": { "get": { "operationId": "raw_fliggy_reviews", "summary": "Fliggy hotel reviews", "description": "Guest reviews of a Fliggy hotel, newest first, up to 100 per page, paginated with cursor. Each review has its score (10-point scale), text, time, reviewer nickname and id (also for anonymous reviews that carry one), IP region, check-in month, room type, trip type, sub-scores, photos and the hotel's reply. A page past the end or an unknown hotel returns an empty, unbilled list.", "tags": [ "Fliggy" ], "parameters": [ { "name": "hotel_id", "in": "query", "required": true, "description": "Fliggy hotel ID (shid, 5–15 digits), e.g. 10052156", "x-qovia-description-zh": "飞猪酒店 ID（shid，5–15 位数字），例如 10052156", "schema": { "type": "string", "pattern": "^[1-9][0-9]{4,14}$", "examples": [ "10052156" ] }, "example": "10052156" }, { "name": "cursor", "in": "query", "required": false, "description": "Page number, from 1", "x-qovia-description-zh": "页码，从 1 开始", "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 1 } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "rid": "524657647", "rating": 10.0, "text": "环境好，服务周到，最主要价格也实惠，推荐入住", "created_at": "2026-10-20T11:32:04+08:00", "author": { "name": "青山依旧1410276752", "uid": "3350595353", "anonymous": false }, "metrics": { "likes": 0, "replies": 0 }, "extra": { "ip_location": "宁夏", "check_in": "2026-09-27", "room_type": "标准双床房", "trip_type": [ "商务出行" ], "dimensions": [ { "name": "位置便利", "score": 10.0 }, { "name": "清洁程度", "score": 10.0 }, { "name": "服务态度", "score": 10.0 }, { "name": "设施体验", "score": 10.0 } ], "photos": [], "videos": [], "merchant_reply": null, "origin": null } }, { "rid": "488818437", "rating": 10.0, "text": "房间干净，空间也很大", "created_at": "2026-04-01T13:54:13+08:00", "author": { "name": "匿名用户", "uid": "2261334455", "anonymous": true }, "metrics": { "likes": 0, "replies": 1 }, "extra": { "ip_location": "浙江", "check_in": "2026-03-30", "room_type": "青蒲大床房", "trip_type": [], "dimensions": [ { "name": "位置便利", "score": 10.0 } ], "photos": [], "videos": [], "merchant_reply": { "text": "亲爱的客人，非常感谢您的肯定！…", "created_at": "2026-04-01T14:52:00+08:00" }, "origin": null } } ], "cursor": 2, "has_more": true }, "meta": { "billed": true, "charged_usd": "0.001500", "balance_usd": "9.998500", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.fliggy.reviews", "x-qovia-title-zh": "飞猪酒店评价", "x-qovia-description-zh": "飞猪酒店的用户评价，按发布时间从新到旧，每页最多 100 条，用 cursor 翻页。每条含评分（10 分制）、正文、 发布时间、评价人昵称与 ID（匿名评价有 ID 时也返回）、IP 属地、入住月份、房型、出行类型、分项评分、图片和店家回复。 翻过最后一页或酒店不存在时返回空列表，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:fliggy", "x-qovia-price": { "mode": "tiered", "unit_price_micros": 1500, "usd_per_call": "0.001500", "usd_per_1k": "1.5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.fliggy.reviews/" } }, "/v1/raw/news/articles": { "get": { "operationId": "raw_news_articles", "summary": "News articles", "description": "Global news by keyword and time window, with summary, sentiment and entities.", "tags": [ "News" ], "parameters": [ { "name": "query", "in": "query", "required": true, "description": "Search keywords", "x-qovia-description-zh": "检索关键词", "schema": { "type": "string", "minLength": 1, "maxLength": 200, "examples": [ "semiconductor earnings" ] }, "example": "semiconductor earnings" }, { "name": "since", "in": "query", "required": false, "description": "Time window: a number plus h (hours) or d (days), such as 24h or 7d", "x-qovia-description-zh": "时间窗：数字加 h（小时）或 d（天），如 24h、7d", "schema": { "type": "string", "pattern": "^[0-9]+(h|d)$", "default": "24h" } }, { "name": "region", "in": "query", "required": false, "description": "Two-letter country or region code, such as us", "x-qovia-description-zh": "两位国家或地区代码，如 us", "schema": { "type": "string", "minLength": 2, "maxLength": 2 } }, { "name": "limit", "in": "query", "required": false, "description": "Number of results", "x-qovia-description-zh": "返回条数", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 20 } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": [ { "id": "web_new_861b", "src": "web", "platform": "news", "lang": "en-US", "title": "Chipmaker beats estimates on AI demand", "sentiment": { "score": 0.41, "label": "positive" }, "entities": [ "semiconductor", "earnings" ] } ], "meta": { "billed": true, "charged_usd": "0.001500", "balance_usd": "9.998500", "empty": false } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "x-qovia-endpoint-id": "raw.news.articles", "x-qovia-title-zh": "新闻文章检索", "x-qovia-description-zh": "按关键词和时间窗检索全球新闻，返回标题、摘要、情感和实体。", "x-qovia-availability": "coming_soon", "x-qovia-status": "beta", "x-qovia-scope": "raw:news", "x-qovia-price": { "mode": "tiered", "unit_price_micros": 1500, "usd_per_call": "0.001500", "usd_per_1k": "1.5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.news.articles/" } }, "/v1/raw/cljx/star_search": { "get": { "operationId": "raw_cljx_star_search", "summary": "Cljx creator search", "description": "Search Kuaishou creators on the Cljx (磁力聚星) marketplace by name keyword, content category and sort order. Returns followers, expected plays, expected CPM, engagement and completion rates and quotes in CNY. Paged, up to 50 per page. Some parameters depend on each other; see x-qovia-params-schema.", "tags": [ "Cili Juxing" ], "parameters": [ { "name": "keyword", "in": "query", "required": false, "description": "Creator nickname keyword; leave out to browse by category and sort", "x-qovia-description-zh": "达人昵称关键词；不传则按分类和排序浏览", "schema": { "type": "string", "minLength": 1, "maxLength": 50, "examples": [ "美食" ] }, "example": "美食" }, { "name": "tag_id", "in": "query", "required": false, "description": "Top-level content category ID, such as 673 food, 677 lifestyle, 695 comedy", "x-qovia-description-zh": "内容一级分类 ID，如 673 美食、677 生活、695 搞笑", "schema": { "type": "string", "pattern": "^[0-9]{3}$" } }, { "name": "sub_ids", "in": "query", "required": false, "description": "Second-level category IDs, comma-separated; needs tag_id", "x-qovia-description-zh": "二级分类 ID，英文逗号分隔，需同时传 tag_id", "schema": { "type": "string", "pattern": "^[0-9]{3}(,[0-9]{3}){0,19}$" } }, { "name": "sort_by", "in": "query", "required": false, "description": "Sort field: 3 default, 2 followers, 20 expected plays, 21 expected CPM, 22 engagement rate, 23 completion rate, 24 follower gain, 25 follower growth rate, 42 deeply connected users, 1 price; live creators also have 26 expected viewers, 27 peak concurrent viewers", "x-qovia-description-zh": "排序字段：3 默认，2 粉丝数，20 预期播放，21 预期 CPM，22 互动率，23 完播率，24 涨粉量，25 涨粉率， 42 深度连接用户数，1 报价；直播达人另有 26 预期观看人数、27 最高在线人数", "schema": { "type": "integer", "enum": [ 3, 1, 2, 20, 21, 22, 23, 24, 25, 26, 27, 42 ], "default": 3 } }, { "name": "sort_order", "in": "query", "required": false, "description": "Sort direction: 1 ascending, 2 descending; must be 0 when sort_by is 3 (default order), and 1 or 2 for any other sort_by", "x-qovia-description-zh": "排序方向：1 升序，2 降序；sort_by 为 3（默认排序）时只能是 0，其他 sort_by 必须传 1 或 2", "schema": { "type": "integer", "enum": [ 0, 1, 2 ], "default": 0 } }, { "name": "star_type", "in": "query", "required": false, "description": "1 short-video creators, 4 live-stream creators", "x-qovia-description-zh": "1 短视频达人，4 直播达人", "schema": { "type": "integer", "enum": [ 1, 4 ], "default": 1 } }, { "name": "page", "in": "query", "required": false, "description": "Page number; the response's cursor is the next page", "x-qovia-description-zh": "页码；响应里的 cursor 就是下一页的 page", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1 } }, { "name": "page_size", "in": "query", "required": false, "description": "Items per page", "x-qovia-description-zh": "每页条数", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 20 } } ], "x-qovia-params-schema": { "type": "object", "additionalProperties": false, "dependentRequired": { "sub_ids": [ "tag_id" ] }, "properties": { "keyword": { "type": "string", "minLength": 1, "maxLength": 50, "description": "Creator nickname keyword; leave out to browse by category and sort", "x-qovia-description-zh": "达人昵称关键词；不传则按分类和排序浏览", "examples": [ "美食" ] }, "tag_id": { "type": "string", "pattern": "^[0-9]{3}$", "description": "Top-level content category ID, such as 673 food, 677 lifestyle, 695 comedy", "x-qovia-description-zh": "内容一级分类 ID，如 673 美食、677 生活、695 搞笑" }, "sub_ids": { "type": "string", "pattern": "^[0-9]{3}(,[0-9]{3}){0,19}$", "description": "Second-level category IDs, comma-separated; needs tag_id", "x-qovia-description-zh": "二级分类 ID，英文逗号分隔，需同时传 tag_id" }, "sort_by": { "type": "integer", "enum": [ 3, 1, 2, 20, 21, 22, 23, 24, 25, 26, 27, 42 ], "default": 3, "description": "Sort field: 3 default, 2 followers, 20 expected plays, 21 expected CPM, 22 engagement rate, 23 completion rate, 24 follower gain, 25 follower growth rate, 42 deeply connected users, 1 price; live creators also have 26 expected viewers, 27 peak concurrent viewers", "x-qovia-description-zh": "排序字段：3 默认，2 粉丝数，20 预期播放，21 预期 CPM，22 互动率，23 完播率，24 涨粉量，25 涨粉率， 42 深度连接用户数，1 报价；直播达人另有 26 预期观看人数、27 最高在线人数" }, "sort_order": { "type": "integer", "enum": [ 0, 1, 2 ], "default": 0, "description": "Sort direction: 1 ascending, 2 descending; must be 0 when sort_by is 3 (default order), and 1 or 2 for any other sort_by", "x-qovia-description-zh": "排序方向：1 升序，2 降序；sort_by 为 3（默认排序）时只能是 0，其他 sort_by 必须传 1 或 2" }, "star_type": { "type": "integer", "enum": [ 1, 4 ], "default": 1, "description": "1 short-video creators, 4 live-stream creators", "x-qovia-description-zh": "1 短视频达人，4 直播达人" }, "page": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1, "description": "Page number; the response's cursor is the next page", "x-qovia-description-zh": "页码；响应里的 cursor 就是下一页的 page" }, "page_size": { "type": "integer", "minimum": 1, "maximum": 50, "default": 20, "description": "Items per page", "x-qovia-description-zh": "每页条数" } }, "allOf": [ { "if": { "required": [ "sort_by" ], "properties": { "sort_by": { "not": { "const": 3 } } } }, "then": { "required": [ "sort_order" ], "properties": { "sort_order": { "enum": [ 1, 2 ] } } }, "else": { "properties": { "sort_order": { "const": 0 } } } } ] }, "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "id": "soc_clj_88eb28227df2", "star_id": "2132268", "user_id": "2613731401", "uid_hash": "fdcfe7f3850d", "name": "美食", "gender": "男", "avatar": "https://p1-ad.adukwai.com/uhead/AB/2026/01/14/13/BMjAyNjAxMTQxMz…", "followers": 245327, "kwai_id": "LG15877565014", "follower_growth": 2000, "follower_growth_rate": 0.0082, "content_tags": [ "三农" ], "mcn": null, "expected_play": 7859, "expected_cpm": 127, "interaction_rate": 0.0, "completion_rate": 0.0, "prices": [ { "type": "直播按小时", "price_cny": 1000 }, { "type": "直播按天", "price_cny": 6000 } ], "live_price_cny": 1000, "live": { "expected_viewers": 23331, "max_viewers": 5091, "expected_cpm": 43, "interaction_rate": 2.5528 }, "prov": { "hash": "0x8204dadd692da227", "ts": "2026-10-20T12:00:00+08:00", "source": "live" } }, { "id": "soc_clj_55e6c9ee38bc", "star_id": "2952902", "user_id": "3212801650", "uid_hash": "008324ac2aba", "name": "美食", "gender": "女", "avatar": "https://p1-ad.adukwai.com/uhead/AB/2026/09/14/21/BMjAyNjA5MTQyMT…", "followers": 23091, "kwai_id": null, "follower_growth": 99, "follower_growth_rate": 0.0043, "content_tags": [ "美食" ], "mcn": null, "expected_play": 51, "expected_cpm": 19608, "interaction_rate": 0.00431, "completion_rate": 0.45354, "prices": [ { "type": "直播按小时", "price_cny": 1000 }, { "type": "直播按天", "price_cny": 3500 } ], "live_price_cny": 1000, "live": null, "prov": { "hash": "0x76677a1e123c5689", "ts": "2026-10-20T12:00:00+08:00", "source": "live" } } ], "cursor": 2, "has_more": true, "total": 1000 }, "meta": { "billed": true, "charged_usd": "0.001500", "balance_usd": "9.998500", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.cljx.star_search", "x-qovia-title-zh": "磁力聚星达人搜索", "x-qovia-description-zh": "按昵称关键词、内容分类和排序条件搜索快手磁力聚星达人，返回粉丝、预期播放、预期 CPM、互动率、完播率和报价（元）。按页翻页，每页最多 50 条。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:cljx", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1500, "usd_per_call": "0.001500", "usd_per_1k": "1.5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.cljx.star_search/" } }, "/v1/raw/cljx/hot_stars": { "get": { "operationId": "raw_cljx_hot_stars", "summary": "Cljx creator charts", "description": "Cljx's official creator charts (reach, rising stars, value for money, top picks; live-commerce and popular streamers) in chart order, with rank changes, platform indices and quotes. One whole chart per call, no paging. Some parameters depend on each other; see x-qovia-params-schema.", "tags": [ "Cili Juxing" ], "parameters": [ { "name": "board", "in": "query", "required": false, "description": "Chart: 105 reach, 104 rising stars, 5 value for money, 106 top picks (short-video creators); 7 sales power, 8 popular hosts (live-stream creators, needs star_type=4)", "x-qovia-description-zh": "榜单：105 传播力表现榜，104 涨粉黑马榜，5 性价比表现榜，106 头部必选榜（短视频达人）； 7 带货实力榜，8 人气主播榜（直播达人，需 star_type=4）", "schema": { "type": "integer", "enum": [ 105, 104, 5, 106, 7, 8 ], "default": 105 } }, { "name": "star_type", "in": "query", "required": false, "description": "1 short-video creators, 4 live-stream creators (charts 7 and 8)", "x-qovia-description-zh": "1 短视频达人，4 直播达人（榜单 7、8）", "schema": { "type": "integer", "enum": [ 1, 4 ], "default": 1 } }, { "name": "tag_id", "in": "query", "required": false, "description": "Top-level content category ID, such as 670 beauty; leave out for all", "x-qovia-description-zh": "内容一级分类 ID，如 670 美妆；不传为全部", "schema": { "type": "integer", "minimum": 1, "maximum": 9999 } } ], "x-qovia-params-schema": { "type": "object", "additionalProperties": false, "properties": { "board": { "type": "integer", "enum": [ 105, 104, 5, 106, 7, 8 ], "default": 105, "description": "Chart: 105 reach, 104 rising stars, 5 value for money, 106 top picks (short-video creators); 7 sales power, 8 popular hosts (live-stream creators, needs star_type=4)", "x-qovia-description-zh": "榜单：105 传播力表现榜，104 涨粉黑马榜，5 性价比表现榜，106 头部必选榜（短视频达人）； 7 带货实力榜，8 人气主播榜（直播达人，需 star_type=4）" }, "star_type": { "type": "integer", "enum": [ 1, 4 ], "default": 1, "description": "1 short-video creators, 4 live-stream creators (charts 7 and 8)", "x-qovia-description-zh": "1 短视频达人，4 直播达人（榜单 7、8）" }, "tag_id": { "type": "integer", "minimum": 1, "maximum": 9999, "description": "Top-level content category ID, such as 670 beauty; leave out for all", "x-qovia-description-zh": "内容一级分类 ID，如 670 美妆；不传为全部" } }, "allOf": [ { "if": { "required": [ "board" ], "properties": { "board": { "enum": [ 7, 8 ] } } }, "then": { "required": [ "star_type" ], "properties": { "star_type": { "const": 4 } } }, "else": { "properties": { "star_type": { "const": 1 } } } } ] }, "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "board": { "id": 105, "name": "传播力表现榜", "description": "根据达人近期传播力指数进行排序，通过个人作品数、个人作品完播率、个人作品播放量中位数、个人作品互动率等维度对达人进行综合评估和筛选", "generated_at": "2026-10-19T10:00:00+08:00" }, "items": [ { "rank": 1, "id": "soc_clj_688e219ccd50", "star_id": "8646245", "user_id": "5188613547", "uid_hash": "8d7793c6d107", "name": "相约在冬季", "gender": "女", "avatar": "https://p1-ad.adukwai.com/uhead/AB/2026/08/22/20/BMjAyNjA4MjIyMD…", "followers": 100133, "rank_change": { "direction": "same", "by": 0 }, "times_on_board": 61, "follower_growth": 52191, "content_tags": [ "生活" ], "indices": { "star": 89.9, "spreading": 94.2, "develop": 98.6, "cost_effective": 76.4 }, "scores": { "spread": 81.6, "conversion": 0.0, "cost_effective": 70.6, "fan_growth": 83.4, "sell_goods": 0.0, "popularity": 0.0 }, "expected_play": 9440, "expected_cpm": 106, "play_median": 617171, "completion_rate": 0.53788, "interaction_rate": 0.10587, "prices": [ { "type": "1-20秒视频", "price_cny": null }, { "type": "21-60秒视频", "price_cny": 1000 } ], "live_price_cny": 1000, "live": { "expected_viewers": 1247, "max_viewers": 221, "expected_cpm": 802, "interaction_rate": 0.3311 }, "prov": { "hash": "0xb52daa318c2610d2", "ts": "2026-10-20T12:00:00+08:00", "source": "live" } }, { "rank": 2, "id": "soc_clj_d4ecd1ee0a99", "star_id": "4857086", "user_id": "1660852705", "uid_hash": "30b6e30e4ea8", "name": "秦观南：长命百岁", "gender": "女", "avatar": "https://p1-ad.adukwai.com/uhead/AB/2024/05/30/12/BMjAyNDA1MzAxMj…", "followers": 1223469, "rank_change": { "direction": "same", "by": 0 }, "times_on_board": 109, "follower_growth": 234320, "content_tags": [ "二次元" ], "indices": { "star": 89.2, "spreading": 93.6, "develop": 97.2, "cost_effective": 82.0 }, "scores": { "spread": 85.8, "conversion": 0.0, "cost_effective": 82.9, "fan_growth": 84.9, "sell_goods": 0.0, "popularity": 0.0 }, "expected_play": 188432, "expected_cpm": 53, "play_median": 1220345, "completion_rate": 0.37012, "interaction_rate": 0.12684, "prices": [ { "type": "1-20秒视频", "price_cny": 8000 }, { "type": "21-60秒视频", "price_cny": 10000 } ], "live_price_cny": 1000, "live": null, "prov": { "hash": "0xcd99380a9f019ed9", "ts": "2026-10-20T12:00:00+08:00", "source": "live" } } ], "cursor": null, "has_more": false, "total": 5 }, "meta": { "billed": true, "charged_usd": "0.001500", "balance_usd": "9.998500", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.cljx.hot_stars", "x-qovia-title-zh": "磁力聚星达人热榜", "x-qovia-description-zh": "磁力聚星官方达人热榜（传播力、涨粉黑马、性价比、头部必选；直播带货实力、人气主播），按榜单顺序返回达人、排名变化、各项指数和报价。每次返回整张榜单，不分页。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:cljx", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1500, "usd_per_call": "0.001500", "usd_per_1k": "1.5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.cljx.hot_stars/" } }, "/v1/raw/cljx/star_profile": { "get": { "operationId": "raw_cljx_star_profile", "summary": "Cljx creator profile", "description": "Creator overview: profile, content tags, 30/90-day follower growth, quotes per video length, expected plays and CPE, chart rank, audience tags and brand-deal record.", "tags": [ "Cili Juxing" ], "parameters": [ { "name": "star_id", "in": "query", "required": true, "description": "Cili Juxing creator ID (starId)", "x-qovia-description-zh": "磁力聚星达人 ID（starId）", "schema": { "type": "string", "pattern": "^[0-9]{1,20}$", "examples": [ "4857086" ] }, "example": "4857086" }, { "name": "star_type", "in": "query", "required": false, "description": "1 short-video creators, 4 live-stream creators", "x-qovia-description-zh": "1 短视频达人，4 直播达人", "schema": { "type": "integer", "enum": [ 1, 4 ], "default": 1 } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "id": "soc_clj_d4ecd1ee0a99", "star_id": "4857086", "user_id": "1660852705", "uid_hash": "30b6e30e4ea8", "name": "秦观南：长命百岁", "gender": "女", "avatar": "https://p4-ad.adukwai.com/uhead/AB/2024/05/30/12/BMjAyNDA1MzAxMj…", "followers": 1222796, "kwai_id": null, "profile_url": "https://www.kuaishou.com/profile/3x4xjp26vizwic6", "bio": null, "region": "浙江-宁波", "verified": null, "identity": "小麦优质", "follower_growth": { "d30": 234320, "d90": 328860 }, "follower_growth_rate": { "d30": 0.2369, "d90": 0.3676 }, "content_tags": { "first": "二次元", "second": "二次元真人秀" }, "content_forms": [], "industry_tags": [], "prices": [ { "type": "1-20秒视频", "price_cny": 8000 }, { "type": "21-60秒视频", "price_cny": 10000 } ], "live_price_cny": null, "expected_play": 188432, "expected_cpe": 0.0, "interaction_rate": 0.0, "weekly_posts": 4, "live": null, "hot_rank": { "board": "传播力表现榜", "rank": 2 }, "audience_tags": { "feature": [ "女性观众为主，占比71.8%", "18-23岁为主，占比30.1%" ], "device": [ "安卓设备为主，占比78.2%", "设备价格在1000-2000的观众居多，占比48.2%" ], "area": [ "三线城市观众居多，占比30.4%", "河南、广东、河北的观众居多" ] }, "orders": { "accept_rate": 1.0, "complete_rate": 0.5, "completed": 1, "advertiser_industries": [ "社交通讯" ] }, "contact": null, "prov": { "hash": "0x30f7ba145e64cd66", "ts": "2026-10-20T12:00:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001500", "balance_usd": "9.998500", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.cljx.star_profile", "x-qovia-title-zh": "磁力聚星达人概览", "x-qovia-description-zh": "达人概览：主页资料、内容标签、30/90 天涨粉、各时长报价、预期播放与 CPE、热榜排名、受众标签和商单履约情况。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:cljx", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1500, "usd_per_call": "0.001500", "usd_per_1k": "1.5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.cljx.star_profile/" } }, "/v1/raw/cljx/star_base": { "get": { "operationId": "raw_cljx_star_base", "summary": "Cljx creator basics", "description": "Creator basics: name, bio, region, followers and growth, MCN, content tags, industries worked with, quotes, credit score and activity flags. Lighter than star_profile and includes the MCN.", "tags": [ "Cili Juxing" ], "parameters": [ { "name": "star_id", "in": "query", "required": true, "description": "Cili Juxing creator ID (starId)", "x-qovia-description-zh": "磁力聚星达人 ID（starId）", "schema": { "type": "string", "pattern": "^[0-9]{1,20}$", "examples": [ "8646245" ] }, "example": "8646245" }, { "name": "star_type", "in": "query", "required": false, "description": "1 short-video creators, 4 live-stream creators", "x-qovia-description-zh": "1 短视频达人，4 直播达人", "schema": { "type": "integer", "enum": [ 1, 4 ], "default": 1 } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "id": "soc_clj_688e219ccd50", "star_id": "8646245", "user_id": "5188613547", "uid_hash": "8d7793c6d107", "name": "相约在冬季", "gender": "女", "avatar": "https://p1-ad.adukwai.com/uhead/AB/2026/08/22/20/BMjAyNjA4MjIyMD…", "followers": 100133, "profile_url": "https://www.kuaishou.com/profile/3xgscnx7wrpfavq", "bio": "喜欢每个粉丝宝宝\n感谢快手官方给予推流\n卡15回\n不活跃不回", "region": null, "follower_growth_rate": 1.0485, "mcn": null, "content_tags": { "first": "情感", "second": "情感（其他）" }, "content_forms": [], "identity": "潜力达人", "industries": [ { "name": "工具软件", "share": 1.0 } ], "prices": [ { "type": "1-20秒视频", "price_cny": null }, { "type": "21-60秒视频", "price_cny": 1000 } ], "credit_score": null, "active": true, "live_active": true, "prov": { "hash": "0x0fe46a5321c08248", "ts": "2026-10-20T12:00:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001500", "balance_usd": "9.998500", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.cljx.star_base", "x-qovia-title-zh": "磁力聚星达人基础信息", "x-qovia-description-zh": "达人个人信息：昵称、简介、地区、粉丝和增长率、MCN、内容标签、合作行业分布、报价、信用分和活跃状态。比 star_profile 轻，含 MCN 信息。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:cljx", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1500, "usd_per_call": "0.001500", "usd_per_1k": "1.5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.cljx.star_base/" } }, "/v1/raw/cljx/star_index": { "get": { "operationId": "raw_cljx_star_index", "summary": "Cljx creator indices", "description": "The platform's six creator indices (overall, growth, reach, appeal, commercial, value for money) with score, peer average, percentile and rank, plus the underlying growth, median plays, completion, engagement and CPM metrics. Takes the Kuaishou user id, not the star id.", "tags": [ "Cili Juxing" ], "parameters": [ { "name": "user_id", "in": "query", "required": true, "description": "Kuaishou user ID (userId; the user_id in star_search results)", "x-qovia-description-zh": "快手用户 ID（userId，star_search 结果里的 user_id）", "schema": { "type": "string", "pattern": "^[0-9]{1,20}$", "examples": [ "5188613547" ] }, "example": "5188613547" }, { "name": "star_type", "in": "query", "required": false, "description": "1 short-video creators, 4 live-stream creators", "x-qovia-description-zh": "1 短视频达人，4 直播达人", "schema": { "type": "integer", "enum": [ 1, 4 ], "default": 1 } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "id": "soc_clj_db4c5b56284d", "user_id": "5188613547", "uid_hash": "8d7793c6d107", "star_type": 1, "updated_at": "2026-10-16", "active_within_3_days": false, "indices": { "star": { "value": 89.88, "avg": null, "percentile": 1.0, "rank": 3 }, "develop": { "value": 98.6, "avg": 68.23, "percentile": 1.0, "rank": 6 }, "spreading": { "value": 94.2, "avg": 65.76, "percentile": 1.0, "rank": 1 }, "appeal": { "value": 97.0, "avg": 69.85, "percentile": 1.0, "rank": 2 }, "business": { "value": 81.0, "avg": 60.59, "percentile": 0.99, "rank": 112 }, "cost_effective": { "value": 76.42, "avg": 73.9, "percentile": 0.59, "rank": 3358 } }, "metrics": { "follower_growth": 52191, "follower_growth_rate": 1.0485, "active_fans_ratio_change": 0.23, "posts": 59, "play_median": 617171, "completion_rate": 0.53788, "interaction_rate": 0.10609, "quality_fans": 72444, "active_fans_ratio": 0.78, "fans_interaction_rate": 0.26, "cooperation_index": 90.0, "completed_orders": 3, "commercial_posts": 3, "commercial_play_median": 12176, "commercial_completion_rate": 0.11465, "commercial_interaction_rate": 0.0086, "expected_cpm": 106.0, "cpc": 0.0, "cpe": 136.957 }, "prov": { "hash": "0x39dca6b60ae21132", "ts": "2026-10-20T12:00:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001500", "balance_usd": "9.998500", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.cljx.star_index", "x-qovia-title-zh": "磁力聚星达人指数", "x-qovia-description-zh": "平台六项达人指数（达人、成长力、传播力、吸引力、商业力、性价比）的分值、同类均值、百分位和排名，以及背后的涨粉、播放中位数、完播率、互动率、CPM 等指标。参数是快手用户 ID（user_id），不是达人 ID。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:cljx", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1500, "usd_per_call": "0.001500", "usd_per_1k": "1.5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.cljx.star_index/" } }, "/v1/raw/cljx/star_audience": { "get": { "operationId": "raw_cljx_star_audience", "summary": "Cljx creator audience", "description": "Follower and viewer profiles: gender, age, activity, province, city, city tier, phone brand and price, interests and audience groups, each with share (fraction) and TGI.", "tags": [ "Cili Juxing" ], "parameters": [ { "name": "star_id", "in": "query", "required": true, "description": "Cili Juxing creator ID (starId)", "x-qovia-description-zh": "磁力聚星达人 ID（starId）", "schema": { "type": "string", "pattern": "^[0-9]{1,20}$", "examples": [ "8646245" ] }, "example": "8646245" }, { "name": "star_type", "in": "query", "required": false, "description": "1 short-video creators, 4 live-stream creators", "x-qovia-description-zh": "1 短视频达人，4 直播达人", "schema": { "type": "integer", "enum": [ 1, 4 ], "default": 1 } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "id": "soc_clj_5c38dacb3c03", "star_id": "8646245", "star_type": 1, "fans": { "gender": [ { "label": "男性", "share": 0.313758, "tgi": 53 }, { "label": "女性", "share": 0.686242, "tgi": 164 } ], "age": [ { "label": "18-23", "share": 0.29023, "tgi": 178 }, { "label": "24-30", "share": 0.214588, "tgi": 136 } ], "activity": [ { "label": "超高活", "share": 0.402549, "tgi": 153 }, { "label": "高活", "share": 0.342346, "tgi": 131 } ], "province": [ { "label": "河南", "share": 0.12502, "tgi": 201 }, { "label": "山东", "share": 0.096168, "tgi": 133 } ], "city": [ { "label": "重庆", "share": 0.020197, "tgi": 117 }, { "label": "保定", "share": 0.015578, "tgi": 178 } ], "city_tier": [ { "label": "firstline", "share": 0.0174662, "tgi": 31 }, { "label": "newfirstline", "share": 0.103149, "tgi": 75 } ], "device_brand": [ { "label": "华为", "share": 0.2824, "tgi": 104 }, { "label": "vivo", "share": 0.205984, "tgi": 106 } ], "device_price": [ { "label": "1000以内", "share": 0.039243, "tgi": 116 }, { "label": "1000-2000", "share": 0.469507, "tgi": 116 } ], "interests": [ { "label": "游戏直播", "share": 0.741155, "tgi": 199 }, { "label": "商品售卖及推荐", "share": 0.667001, "tgi": 92 } ], "groups": [ { "label": "小镇青年", "share": 0.303898, "tgi": 183 }, { "label": "小镇中年", "share": 0.217227, "tgi": 122 } ] }, "viewers": { "gender": [ { "label": "男性", "share": 0.407986, "tgi": 71 }, { "label": "女性", "share": 0.592014, "tgi": 137 } ], "age": [ { "label": "18-23", "share": 0.372717, "tgi": 280 }, { "label": "24-30", "share": 0.184057, "tgi": 153 } ], "activity": [ { "label": "超高活", "share": 0.463711, "tgi": 192 }, { "label": "高活", "share": 0.288226, "tgi": 113 } ], "province": [ { "label": "河南", "share": 0.111206, "tgi": 167 }, { "label": "广东", "share": 0.094889, "tgi": 112 } ], "city": [ { "label": "重庆", "share": 0.019883, "tgi": 110 }, { "label": "邯郸", "share": 0.012884, "tgi": 147 } ], "city_tier": [ { "label": "firstline", "share": 0.0189411, "tgi": 40 }, { "label": "newfirstline", "share": 0.093515, "tgi": 74 } ], "device_brand": [ { "label": "华为", "share": 0.223885, "tgi": 79 }, { "label": "vivo", "share": 0.196913, "tgi": 100 } ], "device_price": [ { "label": "1000以内", "share": 0.0347596, "tgi": 93 }, { "label": "1000-2000", "share": 0.425606, "tgi": 98 } ], "interests": [], "groups": [ { "label": "小镇青年", "share": 0.324198, "tgi": 202 }, { "label": "小镇中年", "share": 0.186774, "tgi": 102 } ] }, "prov": { "hash": "0x305fbc16d183df15", "ts": "2026-10-20T12:00:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001500", "balance_usd": "9.998500", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.cljx.star_audience", "x-qovia-title-zh": "磁力聚星达人受众画像", "x-qovia-description-zh": "粉丝画像和观众画像：性别、年龄、活跃度、省份、城市、城市等级、手机品牌和价位、兴趣、八大人群，每项给占比（小数）和 TGI。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:cljx", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1500, "usd_per_call": "0.001500", "usd_per_1k": "1.5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.cljx.star_audience/" } }, "/v1/raw/cljx/star_works": { "get": { "operationId": "raw_cljx_star_works", "summary": "Cljx creator content performance", "description": "Content performance: recent personal and sponsored videos (plays, likes, comments, shares) and the 30/90-day organic and sponsored median plays, completion, engagement, average interactions and expected CPM.", "tags": [ "Cili Juxing" ], "parameters": [ { "name": "star_id", "in": "query", "required": true, "description": "Cili Juxing creator ID (starId)", "x-qovia-description-zh": "磁力聚星达人 ID（starId）", "schema": { "type": "string", "pattern": "^[0-9]{1,20}$", "examples": [ "8646245" ] }, "example": "8646245" }, { "name": "star_type", "in": "query", "required": false, "description": "1 short-video creators, 4 live-stream creators", "x-qovia-description-zh": "1 短视频达人，4 直播达人", "schema": { "type": "integer", "enum": [ 1, 4 ], "default": 1 } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "id": "soc_clj_f2fc57c18eb6", "star_id": "8646245", "star_type": 1, "personal_works": [ { "id": "soc_kua_970a2743c002", "src": "social", "platform": "kuaishou", "lang": "zh-CN", "text": "#男神", "author": { "star_id": "8646245", "user_id": "5188613547", "uid_hash": "8d7793c6d107" }, "metrics": { "plays": 49, "likes": 17, "comments": 8, "shares": 2 }, "extra": { "source_id": "212820520216", "url": "https://video.kuaishou.com/short-video/3xmtjjhbshc3cwk", "cover": "https://p5-ad.adukwai.com/upic/2026/10/20/12/BMjAyNjEwMjAxMjAwNT…", "published_at": "2026-10-20T12:01:06+08:00", "is_commercial": false } } ], "ad_works": [ { "id": "soc_kua_3ec1bfb5f626", "src": "social", "platform": "kuaishou", "lang": "zh-CN", "text": "又被制裁了 #心动日常", "author": { "star_id": "8646245", "user_id": "5188613547", "uid_hash": "8d7793c6d107" }, "metrics": { "plays": 1137138, "likes": 4615, "comments": 322, "shares": 1574 }, "extra": { "source_id": "209799404938", "url": "https://video.kuaishou.com/short-video/3xwv7ckey6jpzb2", "cover": "https://p5-ad.adukwai.com/upic/2026/09/23/17/BMjAyNjA5MjMxNzAxMT…", "published_at": "2026-09-23T17:01:30+08:00", "is_commercial": true, "industry": "传媒资讯-工具类软件" } } ], "report": { "expected_play": 9440, "expected_cpm": 106.0, "weekly_posts": 25, "organic": { "d30": { "posts": 59, "play_median": 617171, "completion_rate": 0.53788, "interaction_rate": 0.10609, "avg_duration_s": 6.2392, "avg_likes": 43331, "avg_comments": 1509, "avg_shares": 20695 }, "d90": { "posts": 143, "play_median": 554021, "completion_rate": 0.55696, "interaction_rate": 0.09493, "avg_duration_s": 7.67801, "avg_likes": 33230, "avg_comments": 1270, "avg_shares": 16488 } }, "commercial": { "d30": { "posts": 1, "play_median": 12176, "completion_rate": 0.15514, "interaction_rate": 0.02185, "avg_duration_s": 8.833, "avg_likes": 219, "avg_comments": 38, "avg_shares": 9, "conversion_click_rate": 0.000492773, "cpe": 175.0 }, "d90": { "posts": 3, "play_median": 12176, "completion_rate": 0.11465, "interaction_rate": 0.0086, "avg_duration_s": 6.755, "avg_likes": 120, "avg_comments": 24, "avg_shares": 7, "conversion_click_rate": 0.00166383, "cpe": 136.957 } }, "live": { "expected_viewers": 1247, "max_viewers": 221, "expected_cpm": 802.0, "interaction_rate": 0.3311, "weekly_sessions": 10 } }, "prices": [ { "type": "1-20秒视频", "price_cny": null }, { "type": "21-60秒视频", "price_cny": 1000 } ], "prov": { "hash": "0xf6290e34f30fb78e", "ts": "2026-10-20T12:00:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001500", "balance_usd": "9.998500", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.cljx.star_works", "x-qovia-title-zh": "磁力聚星达人传播表现", "x-qovia-description-zh": "传播表现：近期个人作品和商单作品（播放、点赞、评论、分享），以及 30/90 天个人与商单视频的播放中位数、完播率、互动率、平均互动和预期 CPM。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:cljx", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1500, "usd_per_call": "0.001500", "usd_per_1k": "1.5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.cljx.star_works/" } }, "/v1/raw/cljx/star_commerce": { "get": { "operationId": "raw_cljx_star_commerce", "summary": "Cljx creator commerce", "description": "Video commerce: 30/90-day selling videos, orders, GMV, GPM, average order value, product impressions, visits and conversion (CNY), plus the selling videos and their products. Creators without commerce data return an empty, unbilled result.", "tags": [ "Cili Juxing" ], "parameters": [ { "name": "star_id", "in": "query", "required": true, "description": "Cili Juxing creator ID (starId)", "x-qovia-description-zh": "磁力聚星达人 ID（starId）", "schema": { "type": "string", "pattern": "^[0-9]{1,20}$", "examples": [ "34907" ] }, "example": "34907" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "id": "soc_clj_dc33a51b592b", "star_id": "34907", "user_id": "896519214", "uid_hash": "81531bce9b52", "d30": { "videos": 5, "orders": 2, "gmv_cny": 12998, "gpm_cny": 14.71, "avg_order_value_cny": 6499, "product_impressions": 133233, "product_visits": 7839, "conversion_rate": 0.0003 }, "d90": null, "videos": [ { "id": "soc_kua_4d0bb6927e8b", "src": "social", "platform": "kuaishou", "lang": "zh-CN", "text": "本月见 #K100 #新品 #手机 #数码好物", "author": { "star_id": "34907", "user_id": "896519214", "uid_hash": "81531bce9b52" }, "metrics": { "plays": 1420, "likes": 6 }, "extra": { "source_id": "212712450033", "url": "https://video.kuaishou.com/short-video/3xac6r7swgtyt92", "cover": "https://p5-ad.adukwai.com/upic/2026/10/19/10/BMjAyNjEwMTkxMDUyMj…", "published_at": "2026-10-19T10:55:20+08:00", "gmv_cny": 0, "products": [ { "item_id": "27091750631214", "title": "【预约发布会】新品手机 REDMI K100 双芯魔王 万级续航", "cover": "https://p1-ec.ecukwai.com/bs2/image-kwaishop-product/ITEM_IMAGE-…", "price_cny": 9999, "sales": 0 } ] } } ], "prov": { "hash": "0x6d0e386c50cfa11c", "ts": "2026-10-20T12:00:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001500", "balance_usd": "9.998500", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.cljx.star_commerce", "x-qovia-title-zh": "磁力聚星达人电商带货", "x-qovia-description-zh": "短视频带货数据：近 30/90 天带货视频数、订单数、GMV、GPM、客单价、商品曝光与点击、转化率（金额单位元），以及带货视频和挂车商品。没有带货数据的达人返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:cljx", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1500, "usd_per_call": "0.001500", "usd_per_1k": "1.5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.cljx.star_commerce/" } }, "/v1/raw/cljx/star_top_works": { "get": { "operationId": "raw_cljx_star_top_works", "summary": "Cljx creator top videos", "description": "The creator's representative videos with plays, likes, comments, shares, sponsored flag and hit markers; optionally organic traffic only.", "tags": [ "Cili Juxing" ], "parameters": [ { "name": "star_id", "in": "query", "required": true, "description": "Cili Juxing creator ID (starId)", "x-qovia-description-zh": "磁力聚星达人 ID（starId）", "schema": { "type": "string", "pattern": "^[0-9]{1,20}$", "examples": [ "8646245" ] }, "example": "8646245" }, { "name": "organic_only", "in": "query", "required": false, "description": "When true, count organic traffic only (paid promotion excluded)", "x-qovia-description-zh": "true 只统计自然流量（排除广告加热）", "schema": { "type": "boolean", "default": false } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "id": "soc_kua_61d41495a80c", "src": "social", "platform": "kuaishou", "lang": "zh-CN", "text": "大家都选离自己近的人 那我怎么办 我离所有人都那么远", "author": { "star_id": "8646245" }, "metrics": { "plays": 6162, "likes": 717, "comments": 66, "shares": 87 }, "extra": { "source_id": "212771344098", "url": "https://video.kuaishou.com/short-video/3x5gmpazuau365g", "cover": "https://p5-ad.adukwai.com/upic/2026/10/19/21/BMjAyNjEwMTkyMTAzNT…", "published_at": "2026-10-19T21:04:10+08:00", "is_commercial": false, "contains_paid": false, "hot": { "quality": false, "quantity": false, "quality_and_quantity": false } }, "prov": { "hash": "0xdff8cb646ab5302e", "ts": "2026-10-20T12:00:00+08:00", "source": "live" } }, { "id": "soc_kua_bc3054193d2a", "src": "social", "platform": "kuaishou", "lang": "zh-CN", "text": "好无力啊 唉", "author": { "star_id": "8646245" }, "metrics": { "plays": 30405, "likes": 2016, "comments": 135, "shares": 661 }, "extra": { "source_id": "212754908623", "url": "https://video.kuaishou.com/short-video/3xbmhxitcbfyqki", "cover": "https://p5-ad.adukwai.com/upic/2026/10/19/18/BMjAyNjEwMTkxODMzNT…", "published_at": "2026-10-19T18:34:07+08:00", "is_commercial": false, "contains_paid": false, "hot": { "quality": false, "quantity": false, "quality_and_quantity": false } }, "prov": { "hash": "0x1362448d9e50adbe", "ts": "2026-10-20T12:00:00+08:00", "source": "live" } } ], "cursor": null, "has_more": false }, "meta": { "billed": true, "charged_usd": "0.001500", "balance_usd": "9.998500", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.cljx.star_top_works", "x-qovia-title-zh": "磁力聚星达人代表作品", "x-qovia-description-zh": "达人代表作品（作品波动）列表，含播放、点赞、评论、分享、是否商单和爆款标记，可只看自然流量。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:cljx", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1500, "usd_per_call": "0.001500", "usd_per_1k": "1.5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.cljx.star_top_works/" } }, "/v1/raw/cljx/star_stats": { "get": { "operationId": "raw_cljx_star_stats", "summary": "Cljx creator video stats", "description": "30- or 90-day organic and sponsored video stats: posts, average duration, average likes, comments and shares, median plays, completion and engagement; sponsored adds CPM, CPE and expected CPM with change, plus visitor counts.", "tags": [ "Cili Juxing" ], "parameters": [ { "name": "star_id", "in": "query", "required": true, "description": "Cili Juxing creator ID (starId)", "x-qovia-description-zh": "磁力聚星达人 ID（starId）", "schema": { "type": "string", "pattern": "^[0-9]{1,20}$", "examples": [ "8646245" ] }, "example": "8646245" }, { "name": "organic_only", "in": "query", "required": false, "description": "When true, count organic traffic only (paid promotion excluded)", "x-qovia-description-zh": "true 只统计自然流量（排除广告加热）", "schema": { "type": "boolean", "default": false } }, { "name": "window_days", "in": "query", "required": false, "description": "Period in days", "x-qovia-description-zh": "统计周期（天）", "schema": { "type": "integer", "enum": [ 30, 90 ], "default": 30 } }, { "name": "traffic_days", "in": "query", "required": false, "description": "Traffic period in days", "x-qovia-description-zh": "流量统计周期（天）", "schema": { "type": "integer", "enum": [ 7, 15, 30 ], "default": 7 } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "id": "soc_clj_df54213a12f5", "star_id": "8646245", "window_days": 30, "traffic_days": 7, "organic_only": false, "organic": { "posts": 59, "avg_duration_s": 6.2392, "avg_likes": 43331, "avg_comments": 1509, "avg_shares": 20695, "play_median": 617171, "completion_rate": 0.53788, "interaction_rate": 0.10609 }, "commercial": { "posts": 1, "avg_duration_s": 8.833, "avg_likes": 219, "avg_comments": 38, "avg_shares": 9, "play_median": 12176, "completion_rate": 0.15514, "interaction_rate": 0.02185, "conversion_click_rate": 0.000492773, "cpm": 86.2352, "cpe": 175.0, "expected_cpm": 106.0, "expected_cpm_change": -0.51, "expected_play": 9440, "expected_play_change": 1.0495 }, "visitors": 12639216, "deep_visitors": 2017322, "prov": { "hash": "0xc0bbe739c7adccd7", "ts": "2026-10-20T12:00:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001500", "balance_usd": "9.998500", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.cljx.star_stats", "x-qovia-title-zh": "磁力聚星达人数据概览", "x-qovia-description-zh": "近 30 或 90 天个人视频与商单视频的发布数、平均时长、平均点赞评论分享、播放中位数、完播率、互动率，商单另含 CPM、CPE、预期 CPM 及环比，以及访客数。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:cljx", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1500, "usd_per_call": "0.001500", "usd_per_1k": "1.5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.cljx.star_stats/" } }, "/v1/raw/cljx/star_orders": { "get": { "operationId": "raw_cljx_star_orders", "summary": "Cljx creator brand deals", "description": "30- or 90-day brand-deal record: acceptance and completion rates, completed orders and the industries worked with by orders and by views. Creators with no deals return an empty, unbilled result.", "tags": [ "Cili Juxing" ], "parameters": [ { "name": "star_id", "in": "query", "required": true, "description": "Cili Juxing creator ID (starId)", "x-qovia-description-zh": "磁力聚星达人 ID（starId）", "schema": { "type": "string", "pattern": "^[0-9]{1,20}$", "examples": [ "8646245" ] }, "example": "8646245" }, { "name": "window_days", "in": "query", "required": false, "description": "Period in days", "x-qovia-description-zh": "统计周期（天）", "schema": { "type": "integer", "enum": [ 30, 90 ], "default": 30 } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "id": "soc_clj_0ae09bc72acd", "star_id": "8646245", "window_days": 30, "accept_rate": 1.0, "complete_rate": 1.0, "completed_orders": 1, "industries_by_orders": [ { "industry": "工具类软件", "share": 1.0 } ], "industries_by_views": [ { "industry": "工具类软件", "share": 1.0 } ], "prov": { "hash": "0x1754294fe1627499", "ts": "2026-10-20T12:00:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001500", "balance_usd": "9.998500", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.cljx.star_orders", "x-qovia-title-zh": "磁力聚星达人履约表现", "x-qovia-description-zh": "近 30 或 90 天商单履约：接单率、完单率、完成单数，以及合作行业按订单和按播放的分布。没有商单记录的达人返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:cljx", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1500, "usd_per_call": "0.001500", "usd_per_1k": "1.5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.cljx.star_orders/" } }, "/v1/raw/cljx/star_fans_trend": { "get": { "operationId": "raw_cljx_star_fans_trend", "summary": "Cljx creator follower trend", "description": "30- or 90-day follower growth and growth rate, with daily follower counts and daily net change.", "tags": [ "Cili Juxing" ], "parameters": [ { "name": "star_id", "in": "query", "required": true, "description": "Cili Juxing creator ID (starId)", "x-qovia-description-zh": "磁力聚星达人 ID（starId）", "schema": { "type": "string", "pattern": "^[0-9]{1,20}$", "examples": [ "8646245" ] }, "example": "8646245" }, { "name": "window_days", "in": "query", "required": false, "description": "Period in days", "x-qovia-description-zh": "统计周期（天）", "schema": { "type": "integer", "enum": [ 30, 90 ], "default": 30 } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "id": "soc_clj_753fcb77f1a7", "star_id": "8646245", "window_days": 30, "follower_growth": 52191, "follower_growth_rate": 1.0485, "followers_by_day": [ { "date": "2026-09-20", "followers": 49777 }, { "date": "2026-09-21", "followers": 50898 } ], "growth_by_day": [ { "date": "2026-09-21", "delta": 1121 }, { "date": "2026-09-22", "delta": 1519 } ], "prov": { "hash": "0x0eda42564b592dc5", "ts": "2026-10-20T12:00:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001500", "balance_usd": "9.998500", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.cljx.star_fans_trend", "x-qovia-title-zh": "磁力聚星达人粉丝趋势", "x-qovia-description-zh": "近 30 或 90 天的涨粉量、涨粉率，以及每日粉丝数和每日净增。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:cljx", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1500, "usd_per_call": "0.001500", "usd_per_1k": "1.5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.cljx.star_fans_trend/" } }, "/v1/raw/huahuo/creator_search": { "get": { "operationId": "raw_huahuo_creator_search", "summary": "Huahuo creator search", "description": "Search Bilibili creators on the Huahuo (花火) marketplace by nickname or mid. Returns followers and growth, average and median plays, engagement, 30/90/180-day upload counts, quotes per deal type (CNY), CPM/CPC and MCN. Up to 20 results, no paging.", "tags": [ "Huahuo" ], "parameters": [ { "name": "keyword", "in": "query", "required": true, "description": "Bilibili creator nickname or mid", "x-qovia-description-zh": "UP 主昵称或 mid", "schema": { "type": "string", "minLength": 1, "maxLength": 50, "examples": [ "老番茄" ] }, "example": "老番茄" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "id": "soc_hua_8ac527ee462a", "mid": "546195", "uid_hash": "fff53ab53fc7", "nickname": "老番茄", "avatar": "https://i0.hdslb.com/bfs/face/bc5ca101313d4db223c395d64779e76eb3…", "gender": "男", "region": { "province": "上海", "city": "上海" }, "partition": { "name": "游戏", "sub": "单机游戏" }, "followers": 20853367, "follower_growth": 67435, "follower_growth_rate_pct": 0.3, "avg_plays": 4859047, "play_median": 3784176, "interaction_rate": 0.0799, "videos": { "d30": 4, "d90": 11, "d180": 25 }, "hot_video_rate": 1.0, "commercial_videos": 107, "prices": [ { "type": "定制视频", "price_cny": 723300, "discount_price_cny": 723300 }, { "type": "植入视频", "price_cny": 592900, "discount_price_cny": 592900 } ], "cpm": 157.98, "cpc": 141.56, "cpe": null, "tags": [ "游戏实况" ], "cooperation_modes": [ "线下探查拍摄", "小剧场" ], "score": 77.5, "magnetic_level": 7, "traffic_split": { "pc": 0.075, "app": 0.5492 }, "live": { "level": 40, "avg_hourly_viewers_30d": 73217 }, "mcn": { "id": "331257408", "name": "上海超电文化传播有限公司" }, "prov": { "hash": "0x29ac38ac36c40272", "ts": "2026-10-20T12:00:00+08:00", "source": "live" } }, { "id": "soc_hua_7d2f49a0865c", "mid": "1792835265", "uid_hash": "1baac66c8a6c", "nickname": "一只千年老番茄", "avatar": "https://i0.hdslb.com/bfs/face/d4dc1847ed7cba4da2c0a0f8da4530adca…", "gender": "男", "region": { "province": "湖北", "city": "武汉" }, "partition": { "name": "游戏", "sub": "手机游戏" }, "followers": 31849, "follower_growth": 0, "follower_growth_rate_pct": 0.0, "avg_plays": 11291, "play_median": 10937, "interaction_rate": 0.088, "videos": { "d30": 1, "d90": 1, "d180": 5 }, "hot_video_rate": 0.0, "commercial_videos": 0, "prices": [], "cpm": 0.0, "cpc": 0.0, "cpe": null, "tags": [ "游戏实况" ], "cooperation_modes": [], "score": 0.0, "magnetic_level": 0, "traffic_split": { "pc": 0.0054, "app": 0.848 }, "live": null, "mcn": null, "prov": { "hash": "0x753960722c0800a6", "ts": "2026-10-20T12:00:00+08:00", "source": "live" } } ], "cursor": null, "has_more": false, "total": 2 }, "meta": { "billed": true, "charged_usd": "0.001500", "balance_usd": "9.998500", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.huahuo.creator_search", "x-qovia-title-zh": "花火 UP 主搜索", "x-qovia-description-zh": "按昵称或 mid 在 B 站花火平台搜索 UP 主，返回粉丝与增长、平均播放、播放中位数、互动率、近 30/90/180 天投稿数、各合作形式报价（元）、CPM/CPC 和 MCN。最多返回 20 条，不分页。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:huahuo", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1500, "usd_per_call": "0.001500", "usd_per_1k": "1.5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.huahuo.creator_search/" } }, "/v1/raw/huahuo/creator_portrait": { "get": { "operationId": "raw_huahuo_creator_portrait", "summary": "Huahuo creator portrait", "description": "Creator portrait: profile and tags, quotes, average plays, likes, comments, saves, danmaku and engagement, PC/app split, follower and viewer profiles (gender, age, device, region, interests), content and duration mix, top videos, MCN and business contacts.", "tags": [ "Huahuo" ], "parameters": [ { "name": "mid", "in": "query", "required": true, "description": "Bilibili creator mid", "x-qovia-description-zh": "B 站 UP 主 mid", "schema": { "type": "string", "pattern": "^[0-9]{1,20}$", "examples": [ "5294454" ] }, "example": "5294454" }, { "name": "mcn_id", "in": "query", "required": false, "description": "MCN ID; usually left out", "x-qovia-description-zh": "MCN ID，一般不用传", "schema": { "type": "string", "pattern": "^[0-9]{1,20}$", "default": "0" } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "id": "soc_hua_69d53ef708c4", "mid": "5294454", "uid_hash": "064ef3e32322", "nickname": "逗比的雀巢", "avatar": "https://i0.hdslb.com/bfs/face/e56d8c14d3b74b4e32fbaf2ac4af119328…", "gender": "男", "region": { "province": "四川", "city": "成都" }, "partition": { "name": "生活", "sub": "搞笑" }, "followers": 11429893, "bio": "没有ins 商务合作 加微信 NSHOUSE888 某博@逗比的雀大巢 \n编导 剪辑 摄影 有意者联系v zyn_123456231", "total_likes": 98643676, "videos": 152, "tags": [ "搞笑表演" ], "occupation_tags": [ "摄影师" ], "brand_categories": [ "3C及电器", "食品饮料" ], "prices": [ { "type": "定制视频", "price_cny": 1200000, "discount_price_cny": 1200000 }, { "type": "深度定制", "price_cny": 1400000, "discount_price_cny": 1400000 } ], "magnetic_level": 7, "updated_at": "2026-10-18", "averages": { "plays": 14075049, "likes": 1011502, "comments": 24142, "saves": 282479, "danmaku": 20570, "interaction_rate": 0.112 }, "play_median_30d": 9852535, "cpm": 84.66, "traffic_split": { "pc": 0.1144, "app": 0.741 }, "fans_profile": { "gender": [ { "label": "男", "pct": 80.91 }, { "label": "女", "pct": 19.09 } ], "age": [ { "label": "0~17岁", "pct": 19.25 }, { "label": "18~24岁", "pct": 47.19 } ], "device": [ { "label": "苹果", "pct": 26.29 }, { "label": "小米", "pct": 19.06 } ], "province": [ { "label": "广东", "pct": 11.75 }, { "label": "江苏", "pct": 8.53 } ], "interest_tags": [ { "label": "瓶子君152", "score": 925.0 }, { "label": "纯度", "score": 900.0 } ], "categories": [ "游戏", "动画" ], "sub_categories": [ "单机游戏", "手机游戏" ] }, "audience_profile": { "gender": [ { "label": "男", "pct": 77.32 }, { "label": "女", "pct": 22.68 } ], "age": [ { "label": "0~17岁", "pct": 24.87 }, { "label": "18~24岁", "pct": 40.8 } ], "device": [ { "label": "苹果", "pct": 20.38 }, { "label": "华为", "pct": 19.06 } ], "province": [ { "label": "广东", "pct": 11.65 }, { "label": "江苏", "pct": 8.03 } ], "interest_tags": [ { "label": "瓶子君152", "score": 1075.0 }, { "label": "黄金之风", "score": 800.0 } ], "categories": [ "游戏", "动画" ], "sub_categories": [ "单机游戏", "手机游戏" ] }, "fans_vs_visitors": [ { "label": "粉丝", "pct": 33.73 }, { "label": "游客", "pct": 66.27 } ], "content_mix": { "partitions": [ { "label": "生活", "pct": 100.0 } ], "durations": [ { "label": "5-10min", "pct": 80.0 }, { "label": "3-5min", "pct": 20.0 } ] }, "city_tiers": [ { "label": "一线", "pct": 13.63 }, { "label": "新一线", "pct": 21.86 } ], "cooperation_modes": [ "口播广告", "小剧场" ], "top_videos": { "by_plays": { "bvid": "BV1rz7569EWw", "title": "找到了10年前跪舔b站的视频", "cover": "https://i0.hdslb.com/bfs/archive/61b59b6e7ba5d34592401ac162e800e…", "duration_s": 439, "plays": 23839992, "likes": null, "comments": null, "saves": null, "danmaku": null, "interaction_rate": null }, "by_interaction": { "bvid": "BV1rz7569EWw", "title": "找到了10年前跪舔b站的视频", "cover": "https://i0.hdslb.com/bfs/archive/61b59b6e7ba5d34592401ac162e800e…", "duration_s": 439, "plays": null, "likes": 2006497, "comments": 28483, "saves": 559878, "danmaku": 33347, "interaction_rate": 0.1587 } }, "honor": { "bilibili_top100": true, "year": 2025 }, "mcn": { "id": "2140010221", "name": "雀立盛熙" }, "contact": null, "prov": { "hash": "0xaffbd7166ecfd5be", "ts": "2026-10-20T12:00:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001500", "balance_usd": "9.998500", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.huahuo.creator_portrait", "x-qovia-title-zh": "花火 UP 主数据档案", "x-qovia-description-zh": "UP 主数据档案：资料与标签、报价、平均播放/点赞/评论/收藏/弹幕与互动率、PC/移动端占比、粉丝与观众画像（性别、年龄、设备、地域、兴趣）、内容分区与时长分布、代表视频、MCN 和商务联系方式。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:huahuo", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1500, "usd_per_call": "0.001500", "usd_per_1k": "1.5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.huahuo.creator_portrait/" } }, "/v1/raw/huahuo/fans_trend": { "get": { "operationId": "raw_huahuo_fans_trend", "summary": "Huahuo follower growth", "description": "Follower growth and growth rate (percent) over 7/30/90/180/365 days, plus daily follower counts for the last `days` days (up to 366).", "tags": [ "Huahuo" ], "parameters": [ { "name": "mid", "in": "query", "required": true, "description": "Bilibili creator mid", "x-qovia-description-zh": "B 站 UP 主 mid", "schema": { "type": "string", "pattern": "^[0-9]{1,20}$", "examples": [ "5294454" ] }, "example": "5294454" }, { "name": "days", "in": "query", "required": false, "description": "How many recent days of daily follower counts to return", "x-qovia-description-zh": "返回最近多少天的每日粉丝数", "schema": { "type": "integer", "minimum": 1, "maximum": 366, "default": 90 } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "id": "soc_hua_7b524f58d1bc", "mid": "5294454", "uid_hash": "064ef3e32322", "growth": { "d7": 9845, "d30": 51860, "d90": 313658, "d180": 891729, "d365": 1594520 }, "growth_rate_pct": { "d7": 0.09, "d30": 0.46, "d90": 2.82, "d180": 8.46, "d365": 16.21 }, "followers_by_day": [ { "date": "2025-10-18", "followers": 9835373 }, { "date": "2025-10-19", "followers": 9836929 } ], "prov": { "hash": "0xc7f1f585d4b54206", "ts": "2026-10-20T12:00:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001500", "balance_usd": "9.998500", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.huahuo.fans_trend", "x-qovia-title-zh": "花火 UP 主粉丝增长", "x-qovia-description-zh": "近 7/30/90/180/365 天的涨粉数和涨粉率（百分比），以及最近 days 天的每日粉丝数（最多 366 天）。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:huahuo", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1500, "usd_per_call": "0.001500", "usd_per_1k": "1.5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.huahuo.fans_trend/" } }, "/v1/raw/huahuo/video_highlights": { "get": { "operationId": "raw_huahuo_video_highlights", "summary": "Huahuo video highlights", "description": "30/90/180-day upload count, hot and viral video counts and rates, high-engagement rate, and whether each beats the peer median. No uploads in the window returns an empty, unbilled result.", "tags": [ "Huahuo" ], "parameters": [ { "name": "mid", "in": "query", "required": true, "description": "Bilibili creator mid", "x-qovia-description-zh": "B 站 UP 主 mid", "schema": { "type": "string", "pattern": "^[0-9]{1,20}$", "examples": [ "5294454" ] }, "example": "5294454" }, { "name": "day_range", "in": "query", "required": false, "description": "Period: 1 last 30 days, 2 last 90 days, 3 last 180 days", "x-qovia-description-zh": "统计周期：1 近 30 天，2 近 90 天，3 近 180 天", "schema": { "type": "integer", "enum": [ 1, 2, 3 ], "default": 3 } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "id": "soc_hua_a7040259a4f2", "mid": "5294454", "uid_hash": "064ef3e32322", "window_days": 180, "videos": 5, "videos_above_median": false, "hot": { "count": 5, "rate": 1.0, "above_median": true }, "explode": { "count": 5, "rate": 1.0, "above_median": true }, "high_interaction": { "rate": 0.0, "above_median": false }, "prov": { "hash": "0x378a8eaa30a35a0d", "ts": "2026-10-20T12:00:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001500", "balance_usd": "9.998500", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.huahuo.video_highlights", "x-qovia-title-zh": "花火 UP 主视频亮点", "x-qovia-description-zh": "近 30/90/180 天的投稿数、热门稿件数与比例、爆款稿件数与比例、高互动比例，以及是否高于同类中位数。期内没有投稿返回空结果，不计费。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:huahuo", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1500, "usd_per_call": "0.001500", "usd_per_1k": "1.5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.huahuo.video_highlights/" } }, "/v1/raw/huahuo/representative_works": { "get": { "operationId": "raw_huahuo_representative_works", "summary": "Huahuo representative videos", "description": "The creator's representative videos (personal or sponsored) with plays, likes, comments, danmaku, interactions and rate, duration, publish time and sponsor brand.", "tags": [ "Huahuo" ], "parameters": [ { "name": "mid", "in": "query", "required": true, "description": "Bilibili creator mid", "x-qovia-description-zh": "B 站 UP 主 mid", "schema": { "type": "string", "pattern": "^[0-9]{1,20}$", "examples": [ "5294454" ] }, "example": "5294454" }, { "name": "kind", "in": "query", "required": false, "description": "1 personal videos, 2 sponsored videos", "x-qovia-description-zh": "1 个人作品，2 商业合作作品", "schema": { "type": "integer", "enum": [ 1, 2 ], "default": 1 } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "items": [ { "id": "soc_bil_eeed5efddfb3", "src": "social", "platform": "bilibili", "lang": "zh-CN", "text": "不该让爷爷看b站的", "author": { "uid_hash": "064ef3e32322", "mid": "5294454" }, "metrics": { "plays": 19121289, "likes": 1789873, "comments": 42957, "danmaku": 33507, "interactions": 4470975 }, "extra": { "source_id": "BV1xuPYzcEdo", "aid": "116187019222644", "url": "https://www.bilibili.com/video/BV1xuPYzcEdo", "cover": "https://i1.hdslb.com/bfs/archive/bec46259e40b2044b103c673b4efbca…", "published_at": "2026-03-07T16:50:37+08:00", "duration_s": 506, "interaction_rate_pct": 23.38, "kind": "内容稿件" }, "prov": { "hash": "0x0daa34a33525d61a", "ts": "2026-10-20T12:00:00+08:00", "source": "live" } }, { "id": "soc_bil_3a9e8272004d", "src": "social", "platform": "bilibili", "lang": "zh-CN", "text": "加入了galgame青训营", "author": { "uid_hash": "064ef3e32322", "mid": "5294454" }, "metrics": { "plays": 12026831, "likes": 910000, "comments": 24177, "danmaku": 21622, "interactions": 2095291 }, "extra": { "source_id": "BV1qT1jBQEqE", "aid": "115473953919185", "url": "https://www.bilibili.com/video/BV1qT1jBQEqE", "cover": "https://i0.hdslb.com/bfs/archive/de427d89967fdaa6cceb0bfea610b6a…", "published_at": "2025-11-01T18:32:38+08:00", "duration_s": 511, "interaction_rate_pct": 17.42, "kind": "内容稿件" }, "prov": { "hash": "0x77bf268dc60b8d24", "ts": "2026-10-20T12:00:00+08:00", "source": "live" } } ], "cursor": null, "has_more": false }, "meta": { "billed": true, "charged_usd": "0.001500", "balance_usd": "9.998500", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.huahuo.representative_works", "x-qovia-title-zh": "花火 UP 主代表作品", "x-qovia-description-zh": "UP 主的代表作品（个人作品或商业合作作品），含播放、点赞、评论、弹幕、互动数和互动率、时长、发布时间和合作品牌。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:huahuo", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1500, "usd_per_call": "0.001500", "usd_per_1k": "1.5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.huahuo.representative_works/" } }, "/v1/raw/huahuo/video_trend": { "get": { "operationId": "raw_huahuo_video_trend", "summary": "Huahuo video performance", "description": "Recent videos on one metric (plays, likes, comments or danmaku): min, max and median, with each video's value and hot, viral, high-engagement and Huahuo-deal flags.", "tags": [ "Huahuo" ], "parameters": [ { "name": "mid", "in": "query", "required": true, "description": "Bilibili creator mid", "x-qovia-description-zh": "B 站 UP 主 mid", "schema": { "type": "string", "pattern": "^[0-9]{1,20}$", "examples": [ "5294454" ] }, "example": "5294454" }, { "name": "metric", "in": "query", "required": false, "description": "Metric: 3 plays, 4 likes, 5 comments, 6 danmaku", "x-qovia-description-zh": "指标：3 播放，4 点赞，5 评论，6 弹幕", "schema": { "type": "integer", "enum": [ 3, 4, 5, 6 ], "default": 3 } } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "id": "soc_hua_0c8b094e2970", "mid": "5294454", "uid_hash": "064ef3e32322", "metric": "plays", "min": 8860994, "max": 23839992, "median": 12117293, "videos": [ { "id": "soc_bil_4875e17197dc", "src": "social", "platform": "bilibili", "lang": "zh-CN", "text": "唯一能和她跨年的方式😭", "author": { "uid_hash": "064ef3e32322", "mid": "5294454" }, "metrics": { "plays": 11077853 }, "extra": { "source_id": "BV1K6iMBREnR", "aid": "115813138896214", "url": "https://www.bilibili.com/video/BV1K6iMBREnR", "cover": "https://i2.hdslb.com/bfs/archive/c82fff89cc33db3a3ba591ba8de38d0…", "published_at": "2025-12-31T16:08:27+08:00", "flags": { "spark": false, "hot": true, "explode": true, "high_interaction": false } } } ], "prov": { "hash": "0x35ed7072319a52fb", "ts": "2026-10-20T12:00:00+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001500", "balance_usd": "9.998500", "empty": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "402": { "$ref": "#/components/responses/PaymentRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-qovia-endpoint-id": "raw.huahuo.video_trend", "x-qovia-title-zh": "花火 UP 主视频表现", "x-qovia-description-zh": "近期稿件在某项指标（播放、点赞、评论或弹幕）上的表现：最小值、最大值、中位数，以及每个稿件的数值和热门、爆款、高互动、花火商单标记。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:huahuo", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 1500, "usd_per_call": "0.001500", "usd_per_1k": "1.5" }, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.huahuo.video_trend/" } }, "/v1/account": { "get": { "operationId": "get_account", "summary": "Account and key", "description": "Confirms the API key works and returns balance and plan. Not charged.", "tags": [ "Account" ], "responses": { "200": { "description": "The key, and its account's balance and plan. Never charged.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Account" }, "example": { "request_id": "00000000-0000-0000-0000-000000000000", "data": { "user": { "id": "00000000-0000-0000-0000-000000000000", "email": "you@example.com" }, "api_key": { "id": "00000000-0000-0000-0000-000000000000", "name": "production", "scopes": [ "*" ], "expires_at": null }, "billing": { "balance_usd": "10.000000", "plan": "payg", "rpm_limit": null } }, "meta": { "billed": false } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/TooManyRequests" } }, "x-qovia-docs-url": "https://qovia.ai/docs/#account" } } }, "components": { "securitySchemes": { "bearerAuth": { "type": "http", "scheme": "bearer", "bearerFormat": "sk-qovia-…" }, "apiKeyHeader": { "type": "apiKey", "in": "header", "name": "x-api-key" } }, "schemas": { "Meta": { "type": "object", "required": [ "billed", "charged_usd", "balance_usd", "empty" ], "properties": { "billed": { "type": "boolean", "description": "Whether this call was charged to the balance; `false` for empty results." }, "charged_usd": { "type": "string", "description": "Amount charged in USD, 6 decimals; `\"0.000000\"` when nothing was charged." }, "balance_usd": { "type": "string", "description": "Balance after settlement, USD, 6 decimals." }, "empty": { "type": "boolean", "description": "The result is empty: not charged." } } }, "SuccessEnvelope": { "type": "object", "required": [ "request_id", "data", "meta" ], "properties": { "request_id": { "type": "string", "description": "The call's ID (its usage record), also in the `X-Request-Id` header and in the console usage log.", "format": "uuid" }, "data": { "type": [ "object", "array", "null" ], "description": "The endpoint's data; see each endpoint's response example. An empty result may be an empty structure (e.g. empty `items`) or `null`; check `meta.empty`." }, "meta": { "$ref": "#/components/schemas/Meta" } } }, "Error": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "code", "message", "request_id", "support" ], "properties": { "code": { "type": "string", "description": "The error code; see the error table. Branch on `code`.", "enum": [ "invalid_api_key", "too_many_auth_failures", "account_disabled", "payload_too_large", "endpoint_not_found", "method_not_allowed", "endpoint_disabled", "scope_denied", "endpoint_unavailable", "invalid_params", "rate_limited", "too_many_unbilled", "endpoint_busy", "insufficient_balance", "upstream_busy", "upstream_timeout", "upstream_error", "upstream_rejected", "not_found", "reservation_expired" ] }, "message": { "type": "string", "description": "A short English explanation. One code can have several messages (the error table lists them all), so do not branch on it. Never contains the data source's own error text." }, "request_id": { "type": "string", "description": "Same as the `X-Request-Id` header (see below)." }, "support": { "type": "string", "description": "Where to get help (Telegram); include the `request_id` so we can find the call." } } } } }, "Account": { "type": "object", "required": [ "request_id", "data", "meta" ], "properties": { "request_id": { "type": "string" }, "data": { "type": "object", "required": [ "user", "api_key", "billing" ], "properties": { "user": { "type": "object", "required": [ "id", "email" ], "properties": { "id": { "type": "string", "format": "uuid" }, "email": { "type": "string", "format": "email" } } }, "api_key": { "type": "object", "required": [ "id", "name", "scopes", "expires_at" ], "properties": { "id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "scopes": { "type": "array", "items": { "type": "string" } }, "expires_at": { "type": [ "string", "null" ], "format": "date-time" } } }, "billing": { "type": "object", "required": [ "balance_usd", "plan", "rpm_limit" ], "properties": { "balance_usd": { "type": "string", "description": "USD, 6 decimals." }, "plan": { "type": "string", "enum": [ "free", "payg", "enterprise" ] }, "rpm_limit": { "type": [ "integer", "null" ], "description": "Null: no rate limit." } } } } }, "meta": { "type": "object", "required": [ "billed" ], "properties": { "billed": { "type": "boolean", "const": false } } } } } }, "headers": { "X-Request-Id": { "description": "Same as `request_id` in the body. For a reserved call (success, empty, or a failure after reservation) it is the usage record ID; a request refused before reservation keeps the `X-Request-Id` you sent, or gets a generated one.", "schema": { "type": "string" } }, "X-Qovia-Charged": { "description": "Charged for this call, USD, 6 decimals; `0.000000` when nothing was charged or it was refunded.", "schema": { "type": "string" } }, "X-Qovia-Balance": { "description": "Balance after settlement, USD, 6 decimals.", "schema": { "type": "string" } }, "Retry-After": { "description": "Seconds to wait before retrying.", "schema": { "type": "integer" } }, "WWW-Authenticate": { "description": "`Bearer realm=\"qovia\"`.", "schema": { "type": "string" } }, "Allow": { "description": "The methods this path supports.", "schema": { "type": "string" } } }, "responses": { "BadRequest": { "description": "Codes: invalid_params, upstream_rejected. Never charged.", "headers": { "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "examples": { "invalid_params": { "summary": "The parameters failed validation: a required one is missing, a type or format is wrong, an array has more items than allowed, an unknown one was sent, or the POST body is not a JSON object. An error in one parameter starts with its name (`item_id: …`); a missing or unknown parameter starts with `params: …`.", "value": { "error": { "code": "invalid_params", "message": ": ", "request_id": "00000000-0000-0000-0000-000000000000", "support": "https://t.me/scott10081" } } }, "upstream_rejected": { "summary": "The data source rejected these parameters (well-formed, but not accepted); refunded.", "value": { "error": { "code": "upstream_rejected", "message": "the data source rejected these parameters; not charged", "request_id": "00000000-0000-0000-0000-000000000000", "support": "https://t.me/scott10081" } } } } } } }, "Unauthorized": { "description": "Codes: invalid_api_key. Never charged.", "headers": { "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "examples": { "invalid_api_key": { "summary": "The API key is missing, malformed, unknown, revoked or expired.", "value": { "error": { "code": "invalid_api_key", "message": "missing or invalid API key", "request_id": "00000000-0000-0000-0000-000000000000", "support": "https://t.me/scott10081" } } } } } } }, "PaymentRequired": { "description": "Codes: insufficient_balance. Never charged.", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "examples": { "insufficient_balance": { "summary": "The balance cannot pay for this call; top up first.", "value": { "error": { "code": "insufficient_balance", "message": "insufficient balance for this request", "request_id": "00000000-0000-0000-0000-000000000000", "support": "https://t.me/scott10081" } } } } } } }, "Forbidden": { "description": "Codes: account_disabled, scope_denied. Never charged.", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "examples": { "account_disabled": { "summary": "The account is disabled.", "value": { "error": { "code": "account_disabled", "message": "account is disabled", "request_id": "00000000-0000-0000-0000-000000000000", "support": "https://t.me/scott10081" } } }, "scope_denied": { "summary": "This API key lacks the scope the endpoint requires.", "value": { "error": { "code": "scope_denied", "message": "this API key does not have scope ", "request_id": "00000000-0000-0000-0000-000000000000", "support": "https://t.me/scott10081" } } } } } } }, "NotFound": { "description": "Codes: endpoint_not_found, not_found. Never charged.", "headers": { "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "examples": { "endpoint_not_found": { "summary": "No such endpoint; check the method and path.", "value": { "error": { "code": "endpoint_not_found", "message": "no endpoint ", "request_id": "00000000-0000-0000-0000-000000000000", "support": "https://t.me/scott10081" } } }, "not_found": { "summary": "The data source has no such item (deleted, or the ID does not exist); refunded.", "value": { "error": { "code": "not_found", "message": "the data source has no such item; not charged", "request_id": "00000000-0000-0000-0000-000000000000", "support": "https://t.me/scott10081" } } } } } } }, "MethodNotAllowed": { "description": "Codes: method_not_allowed. Never charged.", "headers": { "Allow": { "$ref": "#/components/headers/Allow" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "examples": { "method_not_allowed": { "summary": "The path exists but takes another method; the `Allow` header names it.", "value": { "error": { "code": "method_not_allowed", "message": "use ", "request_id": "00000000-0000-0000-0000-000000000000", "support": "https://t.me/scott10081" } } } } } } }, "Gone": { "description": "Codes: endpoint_disabled. Never charged.", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "examples": { "endpoint_disabled": { "summary": "The endpoint has been retired.", "value": { "error": { "code": "endpoint_disabled", "message": " has been retired", "request_id": "00000000-0000-0000-0000-000000000000", "support": "https://t.me/scott10081" } } } } } } }, "TooManyRequests": { "description": "Codes: too_many_auth_failures. Never charged.", "headers": { "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "examples": { "too_many_auth_failures": { "summary": "30 failed authentications from this IP within a minute; try again in 60 seconds.", "value": { "error": { "code": "too_many_auth_failures", "message": "too many failed authentications; try again later", "request_id": "00000000-0000-0000-0000-000000000000", "support": "https://t.me/scott10081" } } } } } } }, "BadGateway": { "description": "Codes: upstream_error. Never charged.", "headers": { "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "examples": { "upstream_error": { "summary": "The data source failed; refunded.", "value": { "error": { "code": "upstream_error", "message": "the data source failed; not charged", "request_id": "00000000-0000-0000-0000-000000000000", "support": "https://t.me/scott10081" } } } } } } }, "ServiceUnavailable": { "description": "Codes: endpoint_unavailable, upstream_busy, upstream_error. Never charged.", "headers": { "Retry-After": { "$ref": "#/components/headers/Retry-After" }, "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "examples": { "endpoint_unavailable": { "summary": "The endpoint is not available right now (no data source connected yet, or no price configured); nothing ran.", "value": { "error": { "code": "endpoint_unavailable", "message": " is temporarily unavailable", "request_id": "00000000-0000-0000-0000-000000000000", "support": "https://t.me/scott10081" } } }, "upstream_busy": { "summary": "The data source is busy or cooling down; refunded. Retry after `Retry-After`.", "value": { "error": { "code": "upstream_busy", "message": "the data source is busy; retry later; not charged", "request_id": "00000000-0000-0000-0000-000000000000", "support": "https://t.me/scott10081" } } }, "upstream_error": { "summary": "The data source failed; refunded.", "value": { "error": { "code": "upstream_error", "message": "the data source failed; not charged", "request_id": "00000000-0000-0000-0000-000000000000", "support": "https://t.me/scott10081" } } } } } } }, "GatewayTimeout": { "description": "Codes: upstream_timeout, reservation_expired. Never charged.", "headers": { "X-Qovia-Charged": { "$ref": "#/components/headers/X-Qovia-Charged" }, "X-Qovia-Balance": { "$ref": "#/components/headers/X-Qovia-Balance" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "examples": { "upstream_timeout": { "summary": "The data source timed out; refunded.", "value": { "error": { "code": "upstream_timeout", "message": "the data source timed out; not charged", "request_id": "00000000-0000-0000-0000-000000000000", "support": "https://t.me/scott10081" } } }, "reservation_expired": { "summary": "The call took too long and was refunded automatically; no data is returned.", "value": { "error": { "code": "reservation_expired", "message": "the request took too long and was not charged", "request_id": "00000000-0000-0000-0000-000000000000", "support": "https://t.me/scott10081" } } } } } } } } }, "externalDocs": { "url": "https://qovia.ai/docs/" } }