{ "openapi": "3.1.0", "info": { "title": "QQ Huxuan Creator Marketplace Hot Content Trends API (V1)", "version": "v0", "description": "Lists QQ Huxuan hot Video Account content by month and creator category, with six descending sort metrics and page-number pagination. Use it to research monthly content trends for Tencent Huxuan campaign planning." }, "servers": [ { "url": "https://api.justoneapi.com", "description": "Global production API (default)" } ], "tags": [ { "name": "QQ Huxuan Creator Marketplace", "description": "Tencent creator marketplace search, profiles, recent videos, and articles for campaign planning and creator evaluation.", "x-platform-id": "qq-huxuan-creator-marketplace", "x-platform-aliases": [ "QQ Huxuan", "Tencent Huxuan", "腾讯互选", "互选" ], "x-platform-detection-aliases": [ "QQ Huxuan", "Tencent Huxuan", "腾讯互选", "互选" ] } ], "paths": { "/api/qq-huxuan/cgi-bin/advertiser/finder_publisher/get_rank_finder_content/v1": { "get": { "tags": [ "QQ Huxuan Creator Marketplace" ], "summary": "Hot Content Trends", "description": "Lists QQ Huxuan hot Video Account content by month and creator category, with six descending sort metrics and page-number pagination. Use it to research monthly content trends for Tencent Huxuan campaign planning.", "operationId": "getApiQqHuxuanCgiBinAdvertiserFinderPublisherGetRankFinderContentV1", "parameters": [ { "name": "token", "in": "query", "description": "User authentication token.", "required": true, "schema": { "type": "string" } }, { "name": "category", "in": "query", "description": "Creator category. ALL includes every category.\n\nAvailable Values:\n- `ALL`: All creator categories\n- `FOOD`: Food\n- `LIFESTYLE`: Lifestyle\n- `COMEDY`: Comedy\n- `EMOTION`: Emotion and relationships\n- `SOCIETY`: Society\n- `HUMANITIES_ARTS`: Humanities and arts\n- `DRAMA`: Drama\n- `ENTERTAINMENT`: Entertainment\n- `TECHNOLOGY`: Technology\n- `FINANCE`: Finance\n- `FILM_TV_VARIETY`: Film, television and variety shows\n- `GAMING`: Gaming\n- `PARENTING`: Parenting\n- `MUSIC`: Music\n- `TRAVEL`: Travel\n- `SPORTS`: Sports\n- `SCIENCE`: Science education\n- `AUTOMOTIVE`: Automotive\n- `EDUCATION`: Education\n- `CAREER`: Career\n- `HEALTH`: Health\n- `PETS`: Pets", "required": false, "schema": { "type": "string", "default": "ALL", "description": "Creator category for monthly hot content", "enum": [ "ALL", "FOOD", "LIFESTYLE", "COMEDY", "EMOTION", "SOCIETY", "HUMANITIES_ARTS", "DRAMA", "ENTERTAINMENT", "TECHNOLOGY", "FINANCE", "FILM_TV_VARIETY", "GAMING", "PARENTING", "MUSIC", "TRAVEL", "SPORTS", "SCIENCE", "AUTOMOTIVE", "EDUCATION", "CAREER", "HEALTH", "PETS" ] } }, { "name": "sort", "in": "query", "description": "Sort metric. Results are sorted in descending order.\n\nAvailable Values:\n- `INTERACTION`: Interaction count\n- `PLAY`: Play count\n- `THUMB_LIKE`: Thumbs-up like count\n- `HEART_LIKE`: Heart like count\n- `COMMENT`: Comment count\n- `SHARE`: Share count", "required": false, "schema": { "type": "string", "default": "INTERACTION", "description": "Descending sort order for monthly hot content", "enum": [ "INTERACTION", "PLAY", "THUMB_LIKE", "HEART_LIKE", "COMMENT", "SHARE" ] } }, { "name": "month", "in": "query", "description": "Statistics month in yyyy-MM format. Omit to use the latest month available on QQ Huxuan.", "required": false, "schema": { "type": "string" } }, { "name": "page", "in": "query", "description": "Page number, starting at 1. Each page contains up to 48 items.", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" }, "reason": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "400": { "description": "Invalid request parameters or body", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" }, "reason": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "401": { "description": "Invalid or inactive access token", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" }, "reason": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" }, "reason": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "429": { "description": "Request rate or daily quota limit exceeded", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" }, "reason": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" }, "reason": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "503": { "description": "Service temporarily unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" }, "reason": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } } }, "x-order": "16250700", "x-api-version": "v1", "x-docs-slug": "hot-content-trends-v1", "x-search-aliases": [ "腾讯互选内容趋势", "腾讯互选热门内容", "视频号热门内容榜单" ], "x-highlights": [], "x-endpoint-family": "qq_huxuan_cgi_bin_advertiser_finder_publisher_get_rank_finder_content" } } } }