{ "openapi": "3.1.0", "info": { "title": "WeChat Official Accounts Hot Article Search API (V1)", "version": "v0", "description": "Searches hot WeChat Official Account articles within a required date range of up to 7 days, with optional keyword plus publication-format, category, and page filters. Use it to identify high-interest content for trend research or editorial benchmarking." }, "servers": [ { "url": "https://api.justoneapi.com", "description": "Global production API (default)" } ], "tags": [ { "name": "WeChat Official Accounts", "description": "WeChat Official Accounts articles, engagement metrics, search, and publisher timelines for content intelligence.", "x-platform-id": "wechat-official-accounts", "x-platform-aliases": [ "WeChat Official Accounts", "WeChat OA", "微信公众号", "公众号" ], "x-platform-detection-aliases": [ "WeChat Official Accounts", "WeChat OA", "微信公众号", "公众号" ] } ], "paths": { "/api/weixin/search-article-hot/v1": { "get": { "tags": [ "WeChat Official Accounts" ], "summary": "Hot Article Search", "description": "Searches hot WeChat Official Account articles within a required date range of up to 7 days, with optional keyword plus publication-format, category, and page filters. Use it to identify high-interest content for trend research or editorial benchmarking.", "operationId": "getApiWeixinSearchArticleHotV1", "parameters": [ { "name": "token", "in": "query", "description": "Access token for this API service.", "required": true, "schema": { "type": "string" } }, { "name": "keyword", "in": "query", "description": "Optional keyword used to filter hot WeChat Official Account articles.", "required": false, "schema": { "type": "string", "default": "" } }, { "name": "publishType", "in": "query", "description": "Publish type filter for hot WeChat Official Account article results.\n\nAvailable Values:\n- `IMAGE_TEXT`: Image and text article\n- `VIDEO`: Pure video article\n- `AUDIO`: Pure audio or music article\n- `IMAGE`: Pure image article\n- `TEXT`: Pure text article\n- `REPRINT`: Reprinted article", "required": false, "schema": { "type": "string", "default": "IMAGE_TEXT", "description": "Weixin hot article publish type", "enum": [ "IMAGE_TEXT", "VIDEO", "AUDIO", "IMAGE", "TEXT", "REPRINT" ] } }, { "name": "category", "in": "query", "description": "Category filter for hot WeChat Official Account article results.\n\nAvailable Values:\n- `ALL`: All categories\n- `INTERNATIONAL`: International\n- `SPORTS`: Sports\n- `ENTERTAINMENT`: Entertainment\n- `SOCIETY`: Society\n- `FINANCE`: Finance\n- `CURRENT_AFFAIRS`: Current affairs\n- `TECHNOLOGY`: Technology\n- `EMOTION`: Emotion\n- `AUTOMOTIVE`: Automotive\n- `EDUCATION`: Education\n- `FASHION`: Fashion\n- `GAMES`: Games\n- `MILITARY`: Military\n- `TRAVEL`: Travel\n- `FOOD`: Food\n- `CULTURE`: Culture\n- `HEALTH`: Health\n- `HUMOR`: Humor\n- `HOME`: Home\n- `ANIMATION`: Animation\n- `PETS`: Pets\n- `PARENTING`: Parenting\n- `ASTROLOGY`: Astrology\n- `HISTORY`: History\n- `MUSIC`: Music\n- `UNCATEGORIZED`: Uncategorized\n- `COMPREHENSIVE`: Comprehensive\n- `WORKPLACE`: Workplace\n- `AGRICULTURE`: Agriculture\n- `ELDERLY_CARE`: Elderly care", "required": false, "schema": { "type": "string", "default": "ALL", "description": "Weixin hot article category", "enum": [ "ALL", "INTERNATIONAL", "SPORTS", "ENTERTAINMENT", "SOCIETY", "FINANCE", "CURRENT_AFFAIRS", "TECHNOLOGY", "EMOTION", "AUTOMOTIVE", "EDUCATION", "FASHION", "GAMES", "MILITARY", "TRAVEL", "FOOD", "CULTURE", "HEALTH", "HUMOR", "HOME", "ANIMATION", "PETS", "PARENTING", "ASTROLOGY", "HISTORY", "MUSIC", "UNCATEGORIZED", "COMPREHENSIVE", "WORKPLACE", "AGRICULTURE", "ELDERLY_CARE" ] } }, { "name": "page", "in": "query", "description": "Page number starting from 1 for hot WeChat Official Account article results.", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "startDay", "in": "query", "description": "Start date for hot article search in yyyy-MM-dd format. The range through endDay must not exceed 7 days.", "required": true, "schema": { "type": "string" } }, { "name": "endDay", "in": "query", "description": "End date for hot article search in yyyy-MM-dd format. It must be on or after startDay and no more than 7 days later.", "required": true, "schema": { "type": "string" } } ], "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" } }, "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" } }, "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" } }, "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" } }, "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" } }, "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" } }, "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" } }, "required": [ "code", "data", "message", "recordTime" ] } } } } }, "deprecated": true, "x-order": "16101420", "x-api-version": "v1", "x-search-aliases": [ "WeChat hot article search", "WeChat viral Official Account articles", "WeChat trending article finder", "微信公众号热门文章", "微信爆文搜索", "公众号热文榜查询" ], "x-highlights": [], "x-endpoint-family": "weixin_search_article_hot" } } } }