{
  "openapi": "3.0.3",
  "info": {
    "title": "新闻API接口",
    "description": "多频道新闻接口，提供新闻频道查询、关键词检索、发布时间检索和热搜榜单四大核心能力。数据约每5-10分钟刷新一次。仅供内部数据分析、统计及机器学习使用，不得用于终端展示。版权问题请联系新闻发布者。",
    "termsOfService": "https://www.showapi.com/helpcenter/view#/4019/2",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://route.showapi.com"
    }
  ],
  "paths": {
    "/109-37": {
      "x-pointCode": 37,
      "x-mode": "mapping",
      "x-read-timeout": 5,
      "x-connect-timeout": 5,
      "post": {
        "summary": "热搜新闻",
        "description": "热搜新闻功能可提供热搜列表，更新频率约为30分钟一次。",
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ShowapiResEnvelope"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "showapi_res_body": {
                          "type": "object",
                          "properties": {
                            "ret_code": {
                              "type": "number",
                              "description": "是否调用成功"
                            },
                            "top": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "link": {
                                    "type": "string",
                                    "description": "链接"
                                  },
                                  "top": {
                                    "type": "string",
                                    "description": "新闻标题"
                                  }
                                }
                              },
                              "description": "置顶新闻列表"
                            },
                            "hot": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "hot_research": {
                                    "type": "string",
                                    "description": "热搜新闻"
                                  },
                                  "link": {
                                    "type": "string",
                                    "description": "链接"
                                  }
                                }
                              },
                              "description": "全网热搜排行"
                            }
                          },
                          "description": "业务返回体"
                        }
                      }
                    }
                  ]
                }
              }
            }
          }
        },
        "operationId": "109_37_POST",
        "parameters": []
      }
    },
    "/109-36": {
      "x-pointCode": 36,
      "x-mode": "mapping",
      "x-read-timeout": 15,
      "x-connect-timeout": 15,
      "post": {
        "summary": "用发布时间检索新闻",
        "description": "这个接入点可按新闻发布时间检索。建议使用最新类新闻频道（如电商最新频道），这类频道新闻源相对较多，更新速度相对较快。",
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ShowapiResEnvelope"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "showapi_res_body": {
                          "type": "object",
                          "properties": {
                            "pagebean": {
                              "type": "object",
                              "properties": {
                                "allNum": {
                                  "type": "number",
                                  "description": "所有记录数"
                                },
                                "allPages": {
                                  "type": "number",
                                  "description": "所有页数"
                                },
                                "currentPage": {
                                  "type": "number",
                                  "description": "当前页"
                                },
                                "maxResult": {
                                  "type": "number",
                                  "description": "每页最大记录数"
                                },
                                "contentlist": {
                                  "type": "array",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "title": {
                                        "type": "string",
                                        "description": "新闻标题"
                                      },
                                      "link": {
                                        "type": "string",
                                        "description": "新闻详情链接"
                                      },
                                      "pubDate": {
                                        "type": "string",
                                        "description": "发布时间"
                                      },
                                      "source": {
                                        "type": "string",
                                        "description": "来源网站"
                                      },
                                      "channelId": {
                                        "type": "string",
                                        "description": "频道id"
                                      },
                                      "channelName": {
                                        "type": "string",
                                        "description": "频道名称"
                                      },
                                      "id": {
                                        "type": "string",
                                        "description": "新闻对应的外网id"
                                      }
                                    }
                                  },
                                  "description": "数据条目列表"
                                }
                              },
                              "description": "返回的分页结构"
                            },
                            "ret_code": {
                              "type": "string",
                              "description": "成功为0，其他失败"
                            },
                            "remark": {
                              "type": "number",
                              "description": "错误信息"
                            }
                          },
                          "description": "业务返回体"
                        }
                      }
                    }
                  ]
                }
              }
            }
          }
        },
        "operationId": "109_36_POST",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "properties": {
                  "channelId": {
                    "type": "string",
                    "description": "新闻频道id，必须精确匹配"
                  },
                  "channelName": {
                    "type": "string",
                    "description": "新闻频道名称，必须精确匹配"
                  },
                  "title": {
                    "type": "string",
                    "description": "标题名称，可模糊匹配"
                  },
                  "page": {
                    "type": "string",
                    "description": "页数，默认1，最大返回新闻条数为1万条"
                  },
                  "maxResult": {
                    "type": "string",
                    "description": "每页返回记录数，值在20-100之间。"
                  },
                  "beginTime": {
                    "type": "string",
                    "description": "最早的发布时间，使用格式yyyy-MM-dd HH:mm:ss，不传默认当日0点"
                  },
                  "endTime": {
                    "type": "string",
                    "description": "最晚的发布时间，使用格式yyyy-MM-dd HH:mm:ss，不传默认当前时间"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/109-35": {
      "x-pointCode": 35,
      "x-mode": "mapping",
      "x-read-timeout": 15,
      "x-connect-timeout": 15,
      "post": {
        "summary": "新闻查询接口",
        "description": "新闻查询接口可根据频道和关键词查询新闻。建议选用最新类新闻频道（如电商最新频道），这类频道新闻源相对较多，更新速度较快。",
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ShowapiResEnvelope"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "showapi_res_body": {
                          "type": "object",
                          "properties": {
                            "pagebean": {
                              "type": "object",
                              "properties": {
                                "allNum": {
                                  "type": "number",
                                  "description": "所有记录数"
                                },
                                "allPages": {
                                  "type": "number",
                                  "description": "所有页数"
                                },
                                "currentPage": {
                                  "type": "number",
                                  "description": "当前页"
                                },
                                "maxResult": {
                                  "type": "number",
                                  "description": "每页最大记录数"
                                },
                                "contentlist": {
                                  "type": "array",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "title": {
                                        "type": "string",
                                        "description": "新闻标题"
                                      },
                                      "link": {
                                        "type": "string",
                                        "description": "新闻详情链接"
                                      },
                                      "pubDate": {
                                        "type": "string",
                                        "description": "发布时间"
                                      },
                                      "source": {
                                        "type": "string",
                                        "description": "来源网站"
                                      },
                                      "channelId": {
                                        "type": "string",
                                        "description": "频道id"
                                      },
                                      "channelName": {
                                        "type": "string",
                                        "description": "频道名称"
                                      },
                                      "id": {
                                        "type": "string",
                                        "description": "新闻对应的外网id"
                                      },
                                      "desc": {
                                        "type": "string",
                                        "description": "新闻摘要"
                                      }
                                    }
                                  },
                                  "description": "数据条目列表"
                                }
                              },
                              "description": "返回的分页结构"
                            },
                            "ret_code": {
                              "type": "number",
                              "description": "成功为0，其他失败"
                            }
                          },
                          "description": "业务返回体"
                        }
                      }
                    }
                  ]
                }
              }
            }
          }
        },
        "operationId": "109_35_POST",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "properties": {
                  "channelId": {
                    "type": "string",
                    "description": "新闻频道id，必须精确匹配"
                  },
                  "channelName": {
                    "type": "string",
                    "description": "新闻频道名称，可模糊匹配"
                  },
                  "title": {
                    "type": "string",
                    "description": "标题名称，可模糊匹配"
                  },
                  "page": {
                    "type": "string",
                    "description": "页数，默认1，最大返回新闻条数为1万条"
                  },
                  "maxResult": {
                    "type": "string",
                    "description": "每页返回记录数，值在20-100之间。"
                  },
                  "id": {
                    "type": "string",
                    "description": "新闻id，可用此信息取得一条新闻记录"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/109-34": {
      "x-pointCode": 34,
      "x-mode": "mapping",
      "x-read-timeout": 15,
      "x-connect-timeout": 15,
      "post": {
        "summary": "新闻频道查询",
        "description": "建议使用最新类的新闻频道，例如9a15d3d4b5cab17f34e6d7976b1b1f30【电商最新】频道。这类频道新闻源较为丰富，更新速度相对较快。",
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ShowapiResEnvelope"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "showapi_res_body": {
                          "type": "object",
                          "properties": {
                            "totalNum": {
                              "type": "number",
                              "description": "总记录数"
                            },
                            "channelList": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "channelId": {
                                    "type": "string",
                                    "description": "频道id"
                                  },
                                  "name": {
                                    "type": "string",
                                    "description": "频道名称"
                                  }
                                }
                              },
                              "description": "频道列表"
                            },
                            "ret_code": {
                              "type": "number",
                              "description": "0为成功，其他失败"
                            }
                          },
                          "description": "业务返回体"
                        }
                      }
                    }
                  ]
                }
              }
            }
          }
        },
        "operationId": "109_34_POST",
        "parameters": []
      },
      "put": {
        "summary": "新闻频道查询",
        "description": "建议使用最新类的新闻频道，例如9a15d3d4b5cab17f34e6d7976b1b1f30【电商最新】频道。这类频道新闻源较为丰富，更新速度相对较快。",
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ShowapiResEnvelope"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "showapi_res_body": {
                          "type": "object",
                          "properties": {
                            "totalNum": {
                              "type": "number",
                              "description": "总记录数"
                            },
                            "channelList": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "channelId": {
                                    "type": "string",
                                    "description": "频道id"
                                  },
                                  "name": {
                                    "type": "string",
                                    "description": "频道名称"
                                  }
                                }
                              },
                              "description": "频道列表"
                            },
                            "ret_code": {
                              "type": "number",
                              "description": "0为成功，其他失败"
                            }
                          },
                          "description": "业务返回体"
                        }
                      }
                    }
                  ]
                }
              }
            }
          }
        },
        "operationId": "109_34_PUT",
        "parameters": []
      }
    }
  },
  "components": {
    "securitySchemes": {
      "AppKeyAuth": {
        "type": "apiKey",
        "in": "query",
        "name": "appKey",
        "description": "从 ShowAPI 控制台获取的 appKey，管理地址：https://www.showapi.com/console#/myApp"
      }
    },
    "schemas": {
      "ShowapiResEnvelope": {
        "type": "object",
        "description": "ShowAPI 统一返回包裹（业务数据位于 showapi_res_body）",
        "properties": {
          "showapi_res_code": {
            "type": "integer",
            "description": "API 返回的状态码"
          },
          "showapi_res_error": {
            "type": "string",
            "description": "API 返回的错误信息"
          },
          "showapi_res_id": {
            "type": "string",
            "description": "API 请求的唯一标识"
          },
          "showapi_fee_num": {
            "type": "integer",
            "description": "API 调用计费次数"
          }
        }
      }
    }
  },
  "security": [
    {
      "AppKeyAuth": []
    }
  ],
  "externalDocs": {
    "url": "https://www.showapi.com/apiGateway/view/109?tab=book"
  },
  "x-apiCode": "109",
  "x-is-own": false,
  "x-is-op": false
}