{
  "openapi": "3.1.0",
  "info": {
    "title": "微信公众号热门文章搜索 API (V1)",
    "version": "v0",
    "description": "搜索微信公众号热门文章，要求日期范围最多7天，支持可选的关键词、发布格式、类别和页面筛选。用于识别高兴趣内容，进行趋势研究或编辑基准对比。"
  },
  "servers": [
    {
      "url": "https://api.justoneapi.com",
      "description": "全球生产 API（默认）"
    }
  ],
  "tags": [
    {
      "name": "微信公众号",
      "description": "微信公众号文章、互动指标、搜索和发布者时间线，用于内容智能。",
      "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": [
          "微信公众号"
        ],
        "summary": "热门文章搜索",
        "description": "搜索微信公众号热门文章，要求日期范围最多7天，支持可选的关键词、发布格式、类别和页面筛选。用于识别高兴趣内容，进行趋势研究或编辑基准对比。",
        "operationId": "getApiWeixinSearchArticleHotV1",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "description": "此 API 服务的访问令牌。",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "keyword",
            "in": "query",
            "description": "用于筛选热门微信公众号文章的可选关键词。",
            "required": false,
            "schema": {
              "type": "string",
              "default": ""
            }
          },
          {
            "name": "publishType",
            "in": "query",
            "description": "热门微信公众号文章结果的发布类型筛选。\n\n可选值：\n- `IMAGE_TEXT`: 图文文章\n- `VIDEO`: 纯视频文章\n- `AUDIO`: 纯音频或音乐文章\n- `IMAGE`: 纯图片文章\n- `TEXT`: 纯文字文章\n- `REPRINT`: 转载文章",
            "required": false,
            "schema": {
              "type": "string",
              "default": "IMAGE_TEXT",
              "description": "热门微信公众号文章结果的发布类型筛选。",
              "enum": [
                "IMAGE_TEXT",
                "VIDEO",
                "AUDIO",
                "IMAGE",
                "TEXT",
                "REPRINT"
              ]
            }
          },
          {
            "name": "category",
            "in": "query",
            "description": "热门微信公众号文章结果的分类筛选。\n\n可选值：\n- `ALL`: 全部分类\n- `INTERNATIONAL`: 国际\n- `SPORTS`: 体育\n- `ENTERTAINMENT`: 娱乐\n- `SOCIETY`: 社会\n- `FINANCE`: 财经\n- `CURRENT_AFFAIRS`: 时事\n- `TECHNOLOGY`: 科技\n- `EMOTION`: 情感\n- `AUTOMOTIVE`: 汽车\n- `EDUCATION`: 教育\n- `FASHION`: 时尚\n- `GAMES`: 游戏\n- `MILITARY`: 军事\n- `TRAVEL`: 旅游\n- `FOOD`: 美食\n- `CULTURE`: 文化\n- `HEALTH`: 健康\n- `HUMOR`: 幽默\n- `HOME`: 家居\n- `ANIMATION`: 动漫\n- `PETS`: 宠物\n- `PARENTING`: 育儿\n- `ASTROLOGY`: 星座\n- `HISTORY`: 历史\n- `MUSIC`: 音乐\n- `UNCATEGORIZED`: 未分类\n- `COMPREHENSIVE`: 综合\n- `WORKPLACE`: 职场\n- `AGRICULTURE`: 三农\n- `ELDERLY_CARE`: 养老",
            "required": false,
            "schema": {
              "type": "string",
              "default": "ALL",
              "description": "热门微信公众号文章结果的分类筛选。",
              "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": "热门微信公众号文章结果的页码，从1开始。",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 1
            }
          },
          {
            "name": "startDay",
            "in": "query",
            "description": "热门文章搜索的开始日期，格式为yyyy-MM-dd。到结束日期的范围不得超过7天。",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "endDay",
            "in": "query",
            "description": "热门文章搜索的结束日期，格式为yyyy-MM-dd。必须晚于或等于开始日期，且最大不超过7天后。",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "好的",
            "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": "请求参数或请求体无效",
            "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": "访问令牌无效或未激活",
            "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": "权限不足",
            "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": "请求速率或每日配额已超限",
            "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": "服务器内部错误",
            "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": "服务暂时不可用",
            "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"
      }
    }
  }
}