{ "openapi": "3.1.0", "info": { "title": "Qovia API", "version": "0.1.0", "summary": "Public web data API for AI: 73 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\"}}`; branch on `code`.\n- **Billing (USD):** only successful, non-empty results are charged; errors and empty results are free. 1000 free calls per calendar month (Asia/Singapore) on free-eligible endpoints.\n- **Rate limits:** 60 requests per minute per account (600 after the first top-up); some endpoints also have a global per-second cap (429 `endpoint_busy`). Honour `Retry-After`.\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": "Bilibili", "x-qovia-group": "bilibili", "x-qovia-name-zh": "B 站" }, { "name": "Xingtu", "x-qovia-group": "xingtu", "x-qovia-name-zh": "星图" }, { "name": "Tieba", "x-qovia-group": "tieba", "x-qovia-name-zh": "贴吧" }, { "name": "Xiaohongshu", "x-qovia-group": "xiaohongshu", "x-qovia-name-zh": "小红书" }, { "name": "TikTok", "x-qovia-group": "tiktok", "x-qovia-name-zh": "TikTok" }, { "name": "Weibo", "x-qovia-group": "weibo", "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 query across social, e-commerce and web. Semantic + keyword retrieval with unified records, vectors and provenance.", "tags": [ "Search" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "query" ], "additionalProperties": false, "properties": { "query": { "type": "string", "minLength": 1, "maxLength": 500, "description": "What to search for", "x-qovia-description-zh": "检索内容", "examples": [ "通勤咖啡测评" ] }, "domains": { "type": "array", "items": { "type": "string", "enum": [ "social", "ecommerce", "web" ] }, "uniqueItems": true, "default": [ "social", "ecommerce", "web" ], "description": "Only these domains: social, ecommerce, web", "x-qovia-description-zh": "限定领域：social 社交、ecommerce 电商、web 网页" }, "platforms": { "type": "array", "items": { "type": "string" }, "uniqueItems": true, "description": "Only these platforms (slugs)", "x-qovia-description-zh": "限定平台 slug" }, "freshness": { "type": "string", "pattern": "^[0-9]+(h|d)$", "default": "24h", "description": "How recent the results must be, 1h–90d", "x-qovia-description-zh": "1h–90d" }, "format": { "type": "string", "enum": [ "records", "vectors+provenance" ], "default": "vectors+provenance", "description": "Output: records alone, or vectors+provenance to add vectors and provenance", "x-qovia-description-zh": "返回格式：records 只返回记录，vectors+provenance 附带向量和来源证明" }, "limit": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20, "description": "Number of results", "x-qovia-description-zh": "返回条数" } } }, "example": { "query": "通勤咖啡测评" } } } }, "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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_xia_5c8a", "src": "social", "platform": "xiaohongshu", "lang": "zh-CN", "text": "早八人通勤咖啡测评｜这三家真的值", "author": { "uid_hash": "7be2a1", "followers": 56900 }, "metrics": { "likes": 3204, "comments": 517, "saves": 1188 }, "prov": { "hash": "0xf491d8d1", "ts": "2026-07-04T09:12:41+08:00" } } ], "meta": { "billed": true, "charged_usd": "0.004000", "used_free_quota": false, "free_quota_remaining": 0, "balance_usd": "9.996000", "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": "search", "x-qovia-title-zh": "跨域检索", "x-qovia-description-zh": "一次查询同时检索社交、电商、网页三个领域，语义 + 关键词混合，返回统一格式、向量和来源证明。", "x-qovia-availability": "coming_soon", "x-qovia-status": "beta", "x-qovia-scope": "search", "x-qovia-price": { "mode": "tiered", "unit_price_micros": 4000, "usd_per_call": "0.004000", "usd_per_1k": "4" }, "x-qovia-free-eligible": true, "x-qovia-global-rps-cap": 100, "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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.001500", "used_free_quota": false, "free_quota_remaining": 0, "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.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": "tiered", "unit_price_micros": 1500, "usd_per_call": "0.001500", "usd_per_1k": "1.5" }, "x-qovia-free-eligible": true, "x-qovia-global-rps-cap": 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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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.001500", "used_free_quota": false, "free_quota_remaining": 0, "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.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": "tiered", "unit_price_micros": 1500, "usd_per_call": "0.001500", "usd_per_1k": "1.5" }, "x-qovia-free-eligible": true, "x-qovia-global-rps-cap": 3, "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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.001500", "used_free_quota": false, "free_quota_remaining": 0, "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.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": "tiered", "unit_price_micros": 1500, "usd_per_call": "0.001500", "usd_per_1k": "1.5" }, "x-qovia-free-eligible": true, "x-qovia-global-rps-cap": 2, "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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.001500", "used_free_quota": false, "free_quota_remaining": 0, "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.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": "tiered", "unit_price_micros": 1500, "usd_per_call": "0.001500", "usd_per_1k": "1.5" }, "x-qovia-free-eligible": true, "x-qovia-global-rps-cap": 3, "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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.001500", "used_free_quota": false, "free_quota_remaining": 0, "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.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": "tiered", "unit_price_micros": 1500, "usd_per_call": "0.001500", "usd_per_1k": "1.5" }, "x-qovia-free-eligible": true, "x-qovia-global-rps-cap": 2, "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.", "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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, "prov": { "hash": "0x6a1e9c03b5d7f284", "ts": "2026-10-20T12:12:09+08:00", "source": "live" } }, "meta": { "billed": true, "charged_usd": "0.001500", "used_free_quota": false, "free_quota_remaining": 0, "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.douyin.user_search", "x-qovia-title-zh": "抖音用户搜索", "x-qovia-description-zh": "按关键词搜索创作者，返回昵称、sec_uid、粉丝、获赞和认证信息，每页约 12 个。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:douyin", "x-qovia-price": { "mode": "tiered", "unit_price_micros": 1500, "usd_per_call": "0.001500", "usd_per_1k": "1.5" }, "x-qovia-free-eligible": true, "x-qovia-global-rps-cap": 2, "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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.001500", "used_free_quota": false, "free_quota_remaining": 0, "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.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": "tiered", "unit_price_micros": 1500, "usd_per_call": "0.001500", "usd_per_1k": "1.5" }, "x-qovia-free-eligible": true, "x-qovia-global-rps-cap": 1, "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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.001500", "used_free_quota": false, "free_quota_remaining": 0, "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.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": "tiered", "unit_price_micros": 1500, "usd_per_call": "0.001500", "usd_per_1k": "1.5" }, "x-qovia-free-eligible": true, "x-qovia-global-rps-cap": 1, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.douyin.goods_comments/" } }, "/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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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.001500", "used_free_quota": false, "free_quota_remaining": 0, "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.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": "tiered", "unit_price_micros": 1500, "usd_per_call": "0.001500", "usd_per_1k": "1.5" }, "x-qovia-free-eligible": true, "x-qovia-global-rps-cap": 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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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.001500", "used_free_quota": false, "free_quota_remaining": 0, "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.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": "tiered", "unit_price_micros": 1500, "usd_per_call": "0.001500", "usd_per_1k": "1.5" }, "x-qovia-free-eligible": true, "x-qovia-global-rps-cap": 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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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.001500", "used_free_quota": false, "free_quota_remaining": 0, "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.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": "tiered", "unit_price_micros": 1500, "usd_per_call": "0.001500", "usd_per_1k": "1.5" }, "x-qovia-free-eligible": true, "x-qovia-global-rps-cap": 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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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.001500", "used_free_quota": false, "free_quota_remaining": 0, "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.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": "tiered", "unit_price_micros": 1500, "usd_per_call": "0.001500", "usd_per_1k": "1.5" }, "x-qovia-free-eligible": true, "x-qovia-global-rps-cap": 2, "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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.001500", "used_free_quota": false, "free_quota_remaining": 0, "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.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": "tiered", "unit_price_micros": 1500, "usd_per_call": "0.001500", "usd_per_1k": "1.5" }, "x-qovia-free-eligible": true, "x-qovia-global-rps-cap": 2, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.bilibili.danmaku/" } }, "/v1/raw/xingtu/author": { "get": { "operationId": "raw_xingtu_author", "summary": "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": [ "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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.010000", "used_free_quota": false, "free_quota_remaining": 0, "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", "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": 10000, "usd_per_call": "0.010000", "usd_per_1k": "10" }, "x-qovia-free-eligible": false, "x-qovia-global-rps-cap": 3, "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": "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": [ "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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.010000", "used_free_quota": false, "free_quota_remaining": 0, "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_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": 10000, "usd_per_call": "0.010000", "usd_per_1k": "10" }, "x-qovia-free-eligible": false, "x-qovia-global-rps-cap": 2, "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": "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": [ "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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.010000", "used_free_quota": false, "free_quota_remaining": 0, "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_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": 10000, "usd_per_call": "0.010000", "usd_per_1k": "10" }, "x-qovia-free-eligible": false, "x-qovia-global-rps-cap": 3, "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": "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": [ "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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", "used_free_quota": false, "free_quota_remaining": 0, "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-free-eligible": false, "x-qovia-global-rps-cap": 3, "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": "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": [ "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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", "used_free_quota": false, "free_quota_remaining": 0, "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-free-eligible": false, "x-qovia-global-rps-cap": 3, "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": "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": [ "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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", "used_free_quota": false, "free_quota_remaining": 0, "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-free-eligible": false, "x-qovia-global-rps-cap": 3, "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": "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": [ "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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", "used_free_quota": false, "free_quota_remaining": 0, "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-free-eligible": false, "x-qovia-global-rps-cap": 3, "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": "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": [ "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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", "used_free_quota": false, "free_quota_remaining": 0, "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-free-eligible": false, "x-qovia-global-rps-cap": 3, "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": "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": [ "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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", "used_free_quota": false, "free_quota_remaining": 0, "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-free-eligible": false, "x-qovia-global-rps-cap": 3, "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": "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": [ "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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", "used_free_quota": false, "free_quota_remaining": 0, "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-free-eligible": false, "x-qovia-global-rps-cap": 3, "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": "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": [ "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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.010000", "used_free_quota": false, "free_quota_remaining": 0, "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_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": 10000, "usd_per_call": "0.010000", "usd_per_1k": "10" }, "x-qovia-free-eligible": false, "x-qovia-global-rps-cap": 3, "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": "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": [ "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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.010000", "used_free_quota": false, "free_quota_remaining": 0, "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_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": 10000, "usd_per_call": "0.010000", "usd_per_1k": "10" }, "x-qovia-free-eligible": false, "x-qovia-global-rps-cap": 3, "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": "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": [ "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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", "used_free_quota": false, "free_quota_remaining": 0, "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-free-eligible": false, "x-qovia-global-rps-cap": 3, "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": "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": [ "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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", "used_free_quota": false, "free_quota_remaining": 0, "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-free-eligible": false, "x-qovia-global-rps-cap": 3, "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": "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": [ "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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", "used_free_quota": false, "free_quota_remaining": 0, "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-free-eligible": false, "x-qovia-global-rps-cap": 2, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.xingtu.video_transcript/" } }, "/v1/raw/xingtu/videos": { "get": { "operationId": "raw_xingtu_videos", "summary": "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": [ "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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", "used_free_quota": false, "free_quota_remaining": 0, "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-free-eligible": false, "x-qovia-global-rps-cap": 3, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.xingtu.videos/" } }, "/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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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", "used_free_quota": false, "free_quota_remaining": 0, "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-free-eligible": true, "x-qovia-global-rps-cap": 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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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", "used_free_quota": false, "free_quota_remaining": 0, "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-free-eligible": true, "x-qovia-global-rps-cap": 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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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", "used_free_quota": false, "free_quota_remaining": 0, "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-free-eligible": true, "x-qovia-global-rps-cap": 5, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.tieba.user/" } }, "/v1/raw/xiaohongshu/note": { "get": { "operationId": "raw_xiaohongshu_note", "summary": "Xiaohongshu note detail", "description": "Note body, image structure, likes/saves/comments and topics.", "tags": [ "Xiaohongshu" ], "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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_xia_ef86d33b7c64", "src": "social", "platform": "xiaohongshu", "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", "used_free_quota": false, "free_quota_remaining": 0, "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.xiaohongshu.note", "x-qovia-title-zh": "小红书笔记详情", "x-qovia-description-zh": "笔记正文、图片结构、点赞收藏评论数和话题。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:xiaohongshu", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 10000, "usd_per_call": "0.010000", "usd_per_1k": "10" }, "x-qovia-free-eligible": false, "x-qovia-global-rps-cap": 3, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.xiaohongshu.note/" } }, "/v1/raw/xiaohongshu/featured_comments": { "get": { "operationId": "raw_xiaohongshu_featured_comments", "summary": "Xiaohongshu 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" ], "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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.010000", "used_free_quota": false, "free_quota_remaining": 0, "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.xiaohongshu.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:xiaohongshu", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 10000, "usd_per_call": "0.010000", "usd_per_1k": "10" }, "x-qovia-free-eligible": false, "x-qovia-global-rps-cap": 3, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.xiaohongshu.featured_comments/" } }, "/v1/raw/xiaohongshu/creator": { "get": { "operationId": "raw_xiaohongshu_creator", "summary": "Xiaohongshu creator profile", "description": "Creator profile with followers, likes & saves and note count.", "tags": [ "Xiaohongshu" ], "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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", "used_free_quota": false, "free_quota_remaining": 0, "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.xiaohongshu.creator", "x-qovia-title-zh": "小红书博主资料", "x-qovia-description-zh": "博主资料：粉丝数、获赞与收藏、笔记数。", "x-qovia-availability": "live", "x-qovia-status": "beta", "x-qovia-scope": "raw:xiaohongshu", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 10000, "usd_per_call": "0.010000", "usd_per_1k": "10" }, "x-qovia-free-eligible": false, "x-qovia-global-rps-cap": 3, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.xiaohongshu.creator/" } }, "/v1/raw/xiaohongshu/note_search": { "get": { "operationId": "raw_xiaohongshu_note_search", "summary": "Xiaohongshu note search (Pugongying)", "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" ], "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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_xia_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", "used_free_quota": false, "free_quota_remaining": 0, "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.xiaohongshu.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:xiaohongshu", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 10000, "usd_per_call": "0.010000", "usd_per_1k": "10" }, "x-qovia-free-eligible": false, "x-qovia-global-rps-cap": 3, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.xiaohongshu.note_search/" } }, "/v1/raw/xiaohongshu/kol_overview": { "get": { "operationId": "raw_xiaohongshu_kol_overview", "summary": "Xiaohongshu creator overview (Pugongying)", "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 free.", "tags": [ "Xiaohongshu" ], "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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", "used_free_quota": false, "free_quota_remaining": 0, "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.xiaohongshu.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:xiaohongshu", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 10000, "usd_per_call": "0.010000", "usd_per_1k": "10" }, "x-qovia-free-eligible": false, "x-qovia-global-rps-cap": 3, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.xiaohongshu.kol_overview/" } }, "/v1/raw/xiaohongshu/kol_note_performance": { "get": { "operationId": "raw_xiaohongshu_kol_note_performance", "summary": "Xiaohongshu creator note performance (Pugongying)", "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" ], "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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_xia_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", "used_free_quota": false, "free_quota_remaining": 0, "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.xiaohongshu.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:xiaohongshu", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 10000, "usd_per_call": "0.010000", "usd_per_1k": "10" }, "x-qovia-free-eligible": false, "x-qovia-global-rps-cap": 3, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.xiaohongshu.kol_note_performance/" } }, "/v1/raw/xiaohongshu/kol_notes": { "get": { "operationId": "raw_xiaohongshu_kol_notes", "summary": "Xiaohongshu creator notes (Pugongying)", "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. Upstream is slow (about 5-10 s).", "tags": [ "Xiaohongshu" ], "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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_xia_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", "used_free_quota": false, "free_quota_remaining": 0, "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.xiaohongshu.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:xiaohongshu", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 10000, "usd_per_call": "0.010000", "usd_per_1k": "10" }, "x-qovia-free-eligible": false, "x-qovia-global-rps-cap": 3, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.xiaohongshu.kol_notes/" } }, "/v1/raw/xiaohongshu/kol_core_data": { "get": { "operationId": "raw_xiaohongshu_kol_core_data", "summary": "Xiaohongshu creator core data (Pugongying)", "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 free.", "tags": [ "Xiaohongshu" ], "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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", "used_free_quota": false, "free_quota_remaining": 0, "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.xiaohongshu.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:xiaohongshu", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 10000, "usd_per_call": "0.010000", "usd_per_1k": "10" }, "x-qovia-free-eligible": false, "x-qovia-global-rps-cap": 3, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.xiaohongshu.kol_core_data/" } }, "/v1/raw/xiaohongshu/kol_fans_summary": { "get": { "operationId": "raw_xiaohongshu_kol_fans_summary", "summary": "Xiaohongshu creator fan summary (Pugongying)", "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 free.", "tags": [ "Xiaohongshu" ], "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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", "used_free_quota": false, "free_quota_remaining": 0, "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.xiaohongshu.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:xiaohongshu", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 10000, "usd_per_call": "0.010000", "usd_per_1k": "10" }, "x-qovia-free-eligible": false, "x-qovia-global-rps-cap": 3, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.xiaohongshu.kol_fans_summary/" } }, "/v1/raw/xiaohongshu/kol_fans_profile": { "get": { "operationId": "raw_xiaohongshu_kol_fans_profile", "summary": "Xiaohongshu creator fan profile (Pugongying)", "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" ], "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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", "used_free_quota": false, "free_quota_remaining": 0, "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.xiaohongshu.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:xiaohongshu", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 10000, "usd_per_call": "0.010000", "usd_per_1k": "10" }, "x-qovia-free-eligible": false, "x-qovia-global-rps-cap": 3, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.xiaohongshu.kol_fans_profile/" } }, "/v1/raw/xiaohongshu/kol_fans_trend": { "get": { "operationId": "raw_xiaohongshu_kol_fans_trend", "summary": "Xiaohongshu creator follower trend (Pugongying)", "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 free.", "tags": [ "Xiaohongshu" ], "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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", "used_free_quota": false, "free_quota_remaining": 0, "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.xiaohongshu.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:xiaohongshu", "x-qovia-price": { "mode": "fixed", "unit_price_micros": 10000, "usd_per_call": "0.010000", "usd_per_1k": "10" }, "x-qovia-free-eligible": false, "x-qovia-global-rps-cap": 3, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.xiaohongshu.kol_fans_trend/" } }, "/v1/raw/tiktok/video": { "get": { "operationId": "raw_tiktok_video", "summary": "TikTok video detail", "description": "Metadata and engagement metrics for one video.", "tags": [ "TikTok" ], "parameters": [ { "name": "video_id", "in": "query", "required": true, "description": "TikTok video ID", "x-qovia-description-zh": "TikTok 视频 ID", "schema": { "type": "string", "minLength": 1, "examples": [ "7301234567890123456" ] }, "example": "7301234567890123456" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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_41aa", "src": "social", "platform": "tiktok", "lang": "en-US", "text": "3 desk setups under $200", "metrics": { "plays": 1820443, "likes": 210554, "comments": 3021, "shares": 8812 } }, "meta": { "billed": true, "charged_usd": "0.001500", "used_free_quota": false, "free_quota_remaining": 0, "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.tiktok.video", "x-qovia-title-zh": "TikTok 视频详情", "x-qovia-description-zh": "单个视频的元数据和互动数据。", "x-qovia-availability": "coming_soon", "x-qovia-status": "beta", "x-qovia-scope": "raw:tiktok", "x-qovia-price": { "mode": "tiered", "unit_price_micros": 1500, "usd_per_call": "0.001500", "usd_per_1k": "1.5" }, "x-qovia-free-eligible": true, "x-qovia-global-rps-cap": 50, "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": "Comments for a video, cursor-paginated.", "tags": [ "TikTok" ], "parameters": [ { "name": "video_id", "in": "query", "required": true, "description": "TikTok video ID", "x-qovia-description-zh": "TikTok 视频 ID", "schema": { "type": "string", "minLength": 1, "examples": [ "7301234567890123456" ] }, "example": "7301234567890123456" }, { "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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": "t_9001", "text": "where is the lamp from?", "likes": 412 } ], "cursor": 20, "has_more": true }, "meta": { "billed": true, "charged_usd": "0.001500", "used_free_quota": false, "free_quota_remaining": 0, "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.tiktok.comments", "x-qovia-title-zh": "TikTok 视频评论", "x-qovia-description-zh": "视频评论，按游标翻页。", "x-qovia-availability": "coming_soon", "x-qovia-status": "beta", "x-qovia-scope": "raw:tiktok", "x-qovia-price": { "mode": "tiered", "unit_price_micros": 1500, "usd_per_call": "0.001500", "usd_per_1k": "1.5" }, "x-qovia-free-eligible": true, "x-qovia-global-rps-cap": 50, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.tiktok.comments/" } }, "/v1/raw/weibo/post": { "get": { "operationId": "raw_weibo_post", "summary": "Weibo post detail", "description": "Text, media and repost/comment/like counts for one post.", "tags": [ "Weibo" ], "parameters": [ { "name": "post_id", "in": "query", "required": true, "description": "Weibo post mid", "x-qovia-description-zh": "微博 mid", "schema": { "type": "string", "minLength": 1, "examples": [ "5084231748501234" ] }, "example": "5084231748501234" } ], "responses": { "200": { "description": "Success. Charged only when data is non-empty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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_2b10", "src": "social", "platform": "weibo", "lang": "zh-CN", "text": "今天的发布会信息量有点大", "metrics": { "reposts": 1203, "comments": 884, "likes": 9310 } }, "meta": { "billed": true, "charged_usd": "0.001500", "used_free_quota": false, "free_quota_remaining": 0, "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.weibo.post", "x-qovia-title-zh": "微博详情", "x-qovia-description-zh": "单条微博的正文、图片视频和转评赞。", "x-qovia-availability": "coming_soon", "x-qovia-status": "beta", "x-qovia-scope": "raw:weibo", "x-qovia-price": { "mode": "tiered", "unit_price_micros": 1500, "usd_per_call": "0.001500", "usd_per_1k": "1.5" }, "x-qovia-free-eligible": true, "x-qovia-global-rps-cap": 30, "x-qovia-docs-url": "https://qovia.ai/docs/api-reference/raw.weibo.post/" } }, "/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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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", "used_free_quota": false, "free_quota_remaining": 0, "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-free-eligible": true, "x-qovia-global-rps-cap": 30, "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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", "used_free_quota": false, "free_quota_remaining": 0, "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-free-eligible": true, "x-qovia-global-rps-cap": 30, "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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", "used_free_quota": false, "free_quota_remaining": 0, "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-free-eligible": true, "x-qovia-global-rps-cap": 30, "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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", "used_free_quota": false, "free_quota_remaining": 0, "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-free-eligible": true, "x-qovia-global-rps-cap": 30, "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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", "used_free_quota": false, "free_quota_remaining": 0, "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-free-eligible": true, "x-qovia-global-rps-cap": 30, "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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", "used_free_quota": false, "free_quota_remaining": 0, "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-free-eligible": true, "x-qovia-global-rps-cap": 2, "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 when the upstream has 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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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", "used_free_quota": false, "free_quota_remaining": 0, "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-free-eligible": true, "x-qovia-global-rps-cap": 2, "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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", "used_free_quota": false, "free_quota_remaining": 0, "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-free-eligible": true, "x-qovia-global-rps-cap": 50, "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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", "used_free_quota": false, "free_quota_remaining": 0, "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-free-eligible": false, "x-qovia-global-rps-cap": 1, "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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", "used_free_quota": false, "free_quota_remaining": 0, "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-free-eligible": false, "x-qovia-global-rps-cap": 1, "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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", "used_free_quota": false, "free_quota_remaining": 0, "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-free-eligible": false, "x-qovia-global-rps-cap": 1, "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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", "used_free_quota": false, "free_quota_remaining": 0, "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-free-eligible": false, "x-qovia-global-rps-cap": 1, "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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", "used_free_quota": false, "free_quota_remaining": 0, "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-free-eligible": false, "x-qovia-global-rps-cap": 1, "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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", "used_free_quota": false, "free_quota_remaining": 0, "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-free-eligible": false, "x-qovia-global-rps-cap": 1, "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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", "used_free_quota": false, "free_quota_remaining": 0, "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-free-eligible": false, "x-qovia-global-rps-cap": 1, "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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", "used_free_quota": false, "free_quota_remaining": 0, "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-free-eligible": false, "x-qovia-global-rps-cap": 1, "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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", "used_free_quota": false, "free_quota_remaining": 0, "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-free-eligible": false, "x-qovia-global-rps-cap": 1, "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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", "used_free_quota": false, "free_quota_remaining": 0, "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-free-eligible": false, "x-qovia-global-rps-cap": 1, "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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", "used_free_quota": false, "free_quota_remaining": 0, "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-free-eligible": false, "x-qovia-global-rps-cap": 1, "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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", "used_free_quota": false, "free_quota_remaining": 0, "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-free-eligible": false, "x-qovia-global-rps-cap": 1, "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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", "used_free_quota": false, "free_quota_remaining": 0, "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-free-eligible": false, "x-qovia-global-rps-cap": 1, "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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", "used_free_quota": false, "free_quota_remaining": 0, "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-free-eligible": false, "x-qovia-global-rps-cap": 1, "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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", "used_free_quota": false, "free_quota_remaining": 0, "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-free-eligible": false, "x-qovia-global-rps-cap": 1, "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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", "used_free_quota": false, "free_quota_remaining": 0, "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-free-eligible": false, "x-qovia-global-rps-cap": 1, "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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", "used_free_quota": false, "free_quota_remaining": 0, "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-free-eligible": false, "x-qovia-global-rps-cap": 1, "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-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "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", "used_free_quota": false, "free_quota_remaining": 0, "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-free-eligible": false, "x-qovia-global-rps-cap": 1, "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, plan, per-minute limit and this month's free quota. Free, but counts toward the rate limit.", "tags": [ "Account" ], "responses": { "200": { "description": "The key, its account's balance and plan, and this month's free quota. Never charged.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "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": 600, "free_quota": { "limit": 1000, "used": 12, "remaining": 988, "resets_at": "2026-11-01T00:00:00+08:00" } } }, "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", "used_free_quota", "free_quota_remaining", "balance_usd", "empty" ], "properties": { "billed": { "type": "boolean", "description": "Whether this call was charged to the balance; `false` for free-quota calls and empty results." }, "charged_usd": { "type": "string", "description": "Amount charged in USD, 6 decimals; `\"0.000000\"` when nothing was charged." }, "used_free_quota": { "type": "boolean", "description": "Whether this call used the free quota." }, "free_quota_remaining": { "type": "integer", "description": "Free calls left this month." }, "balance_usd": { "type": "string", "description": "Balance after settlement, USD, 6 decimals." }, "empty": { "type": "boolean", "description": "The result is empty: not charged, and a used free call is given back." } } }, "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" ], "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", "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)." } } } } }, "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", "free_quota" ], "properties": { "balance_usd": { "type": "string", "description": "USD, 6 decimals." }, "plan": { "type": "string", "enum": [ "free", "payg", "enterprise" ] }, "rpm_limit": { "type": "integer" }, "free_quota": { "type": "object", "required": [ "limit", "used", "remaining", "resets_at" ], "properties": { "limit": { "type": "integer" }, "used": { "type": "integer" }, "remaining": { "type": "integer" }, "resets_at": { "type": "string", "format": "date-time" } } } } } } }, "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-RateLimit-Limit": { "description": "The account's requests-per-minute limit.", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left in the current 60-second window.", "schema": { "type": "integer" } }, "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" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "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 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" } } }, "upstream_rejected": { "summary": "The data source rejected these parameters (well-formed, but not accepted); refunded.", "value": { "error": { "code": "upstream_rejected", "message": "the upstream rejected these parameters; not charged", "request_id": "00000000-0000-0000-0000-000000000000" } } } } } } }, "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" } } } } } } }, "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 (the free quota is used up, or the endpoint does not use it).", "value": { "error": { "code": "insufficient_balance", "message": "insufficient balance for this request", "request_id": "00000000-0000-0000-0000-000000000000" } } } } } } }, "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" } } }, "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" } } } } } } }, "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" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "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" } } }, "not_found": { "summary": "The data source has no such item (deleted, or the ID does not exist); refunded.", "value": { "error": { "code": "not_found", "message": "no such item upstream; not charged", "request_id": "00000000-0000-0000-0000-000000000000" } } } } } } }, "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" } } } } } } }, "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" } } } } } } }, "TooManyRequests": { "description": "Codes: too_many_auth_failures, rate_limited, too_many_unbilled, endpoint_busy. Never charged.", "headers": { "Retry-After": { "$ref": "#/components/headers/Retry-After" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "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" } } }, "rate_limited": { "summary": "Over the account's per-minute limit (sliding 60-second window); wait for `Retry-After`.", "value": { "error": { "code": "rate_limited", "message": "rate limit exceeded", "request_id": "00000000-0000-0000-0000-000000000000" } } }, "too_many_unbilled": { "summary": "In the last 10 minutes at least 50 of your calls to data sources, and over 80% of them, came back empty, not found or rejected; slow down.", "value": { "error": { "code": "too_many_unbilled", "message": "too many recent requests came back empty, not found or rejected; slow down. Not charged", "request_id": "00000000-0000-0000-0000-000000000000" } } }, "endpoint_busy": { "summary": "The endpoint's per-second capacity across all users is full; retry in 1 second. This does not count toward your per-minute limit.", "value": { "error": { "code": "endpoint_busy", "message": " is at capacity; retry shortly", "request_id": "00000000-0000-0000-0000-000000000000" } } } } } } }, "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" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "examples": { "upstream_error": { "summary": "The data source failed; refunded.", "value": { "error": { "code": "upstream_error", "message": "upstream failed; not charged", "request_id": "00000000-0000-0000-0000-000000000000" } } } } } } }, "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" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "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" } } }, "upstream_busy": { "summary": "The data source is busy or cooling down; refunded. Retry after `Retry-After`.", "value": { "error": { "code": "upstream_busy", "message": "upstream is busy; retry later; not charged", "request_id": "00000000-0000-0000-0000-000000000000" } } }, "upstream_error": { "summary": "The data source failed; refunded.", "value": { "error": { "code": "upstream_error", "message": "upstream failed; not charged", "request_id": "00000000-0000-0000-0000-000000000000" } } } } } } }, "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" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "examples": { "upstream_timeout": { "summary": "The data source timed out; refunded.", "value": { "error": { "code": "upstream_timeout", "message": "upstream timed out; not charged", "request_id": "00000000-0000-0000-0000-000000000000" } } }, "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" } } } } } } } } }, "externalDocs": { "url": "https://qovia.ai/docs/" } }