{
    "openapi": "3.0.0",
    "info": {
        "title": "头条热门新闻 - API文档",
        "version": "1.0.0",
        "description": "今日头条热门新闻，注意该接口已暂停更新，可查询2019-2022年历史数据。（MCP 服务由 分类新闻 接口统一提供）"
    },
    "servers": [
        {
            "url": "https:\/\/apis.tianapi.com"
        }
    ],
    "paths": {
        "\/topnews\/index": {
            "get": {
                "summary": "头条新闻列表",
                "tags": [
                    "头条热门新闻"
                ],
                "description": "",
                "parameters": [
                    {
                        "name": "key",
                        "in": "query",
                        "description": "API密钥",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "description": "API密钥"
                        }
                    },
                    {
                        "name": "num",
                        "in": "query",
                        "description": "返回数量1-50，默认10",
                        "required": false,
                        "schema": {
                            "type": "int",
                            "example": 10,
                            "description": "返回数量1-50，默认10"
                        }
                    },
                    {
                        "name": "src",
                        "in": "query",
                        "description": "指定来源",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "example": "人民日报",
                            "description": "指定来源"
                        }
                    },
                    {
                        "name": "page",
                        "in": "query",
                        "description": "翻页",
                        "required": false,
                        "schema": {
                            "type": "int",
                            "example": 1,
                            "description": "翻页"
                        }
                    },
                    {
                        "name": "word",
                        "in": "query",
                        "description": "搜索关键词",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "example": "上海",
                            "description": "搜索关键词"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "成功响应",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "id": {
                                            "type": "string",
                                            "example": "6010bdf651a5a4ae04511014f2c4bcd6",
                                            "description": "新闻唯一ID"
                                        },
                                        "ctime": {
                                            "type": "string",
                                            "example": "2019-07-07 16:40:29",
                                            "description": "发布时间"
                                        },
                                        "title": {
                                            "type": "string",
                                            "example": "大三女生穿破洞牛仔裤外出，外婆拉着手不让出门",
                                            "description": "新闻标题"
                                        },
                                        "allnum": {
                                            "type": "int",
                                            "example": 625,
                                            "description": "结果数"
                                        },
                                        "picUrl": {
                                            "type": "string",
                                            "example": "http:\/\/p9-tt.byteimg.com\/list\/pgc-image\/7c4efd211ee84a4ca0a2fca99d2e9b95",
                                            "description": "封面图片"
                                        },
                                        "source": {
                                            "type": "string",
                                            "example": "重庆青年报",
                                            "description": "新闻来源"
                                        },
                                        "curpage": {
                                            "type": "int",
                                            "example": 1,
                                            "description": "当前页"
                                        },
                                        "description": {
                                            "type": "string",
                                            "example": "近日，四川省苍溪县，大三学生陶青梅放暑假待在家中...",
                                            "description": "新闻描述"
                                        }
                                    }
                                },
                                "example": {
                                    "msg": "success",
                                    "code": 200,
                                    "result": {
                                        "list": [
                                            {
                                                "id": "6010bdf651a5a4ae04511014f2c4bcd6",
                                                "url": "http:\/\/toutiao.com\/group\/6708637225535406606\/",
                                                "ctime": "2019-07-08 05:58:28",
                                                "title": "女子独自一人深夜约见男网友 却被困民房五小时 结果被伤害四次",
                                                "picUrl": "http:\/\/p6-tt.byteimg.com\/list\/tos-cn-i-0000\/9aa800e29be911e9b2977cd30a55d46c",
                                                "source": "经视看天下",
                                                "description": "女子独自一人深夜约见男网友 却被困民房五小时 结果被伤害四次"
                                            },
                                            {
                                                "id": "b0f86b4bb6e755295b9cc1f710fe4132",
                                                "url": "http:\/\/toutiao.com\/group\/6710866210608644619\/",
                                                "ctime": "2019-07-07 18:28:19",
                                                "title": "加州7.1级强震后，数万蜜蜂离奇坠地身亡，尸横遍野，震惊网民",
                                                "picUrl": "http:\/\/p9-tt.byteimg.com\/list\/pgc-image\/RVX52A65Pj0fEF",
                                                "source": "南方都市报",
                                                "description": "7.1级地震发生后，加州居民哈利勒惊恐地发现屋外空地上大批蜜蜂坠地死亡，尸横遍野。在美国加州当地时间6日再次发生7.1级地震之后，加州一位居民在社交媒体上发布视频，显示成千上万的蜜蜂在他家屋外的空地上坠地身亡，可谓“尸横遍野”。"
                                            },
                                            {
                                                "id": "9e6ea240842cd6aefe3e1c735e69bcea",
                                                "url": "http:\/\/toutiao.com\/group\/6710838421994078732\/",
                                                "ctime": "2019-07-07 16:40:29",
                                                "title": "大三女生穿破洞牛仔裤外出，外婆拉着手不让出门",
                                                "picUrl": "http:\/\/p9-tt.byteimg.com\/list\/pgc-image\/7c4efd211ee84a4ca0a2fca99d2e9b95",
                                                "source": "重庆青年报",
                                                "description": "近日，四川省苍溪县，大三学生陶青梅放暑假待在家中，这天她准备和78岁的外婆一起出门逛逛，于是换好了衣服将自己简单地收拾了一下。"
                                            }
                                        ],
                                        "allnum": 2363,
                                        "curpage": 1
                                    }
                                }
                            }
                        }
                    }
                }
            },
            "post": {
                "summary": "头条新闻列表",
                "tags": [
                    "头条热门新闻"
                ],
                "description": "",
                "requestBody": {
                    "content": {
                        "application\/x-www-form-urlencoded": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "key": {
                                        "type": "string",
                                        "description": "API密钥"
                                    },
                                    "num": {
                                        "type": "int",
                                        "example": 10,
                                        "description": "返回数量1-50，默认10"
                                    },
                                    "src": {
                                        "type": "string",
                                        "example": "人民日报",
                                        "description": "指定来源"
                                    },
                                    "page": {
                                        "type": "int",
                                        "example": 1,
                                        "description": "翻页"
                                    },
                                    "word": {
                                        "type": "string",
                                        "example": "上海",
                                        "description": "搜索关键词"
                                    }
                                },
                                "required": [
                                    "key"
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "成功响应",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "id": {
                                            "type": "string",
                                            "example": "6010bdf651a5a4ae04511014f2c4bcd6",
                                            "description": "新闻唯一ID"
                                        },
                                        "ctime": {
                                            "type": "string",
                                            "example": "2019-07-07 16:40:29",
                                            "description": "发布时间"
                                        },
                                        "title": {
                                            "type": "string",
                                            "example": "大三女生穿破洞牛仔裤外出，外婆拉着手不让出门",
                                            "description": "新闻标题"
                                        },
                                        "allnum": {
                                            "type": "int",
                                            "example": 625,
                                            "description": "结果数"
                                        },
                                        "picUrl": {
                                            "type": "string",
                                            "example": "http:\/\/p9-tt.byteimg.com\/list\/pgc-image\/7c4efd211ee84a4ca0a2fca99d2e9b95",
                                            "description": "封面图片"
                                        },
                                        "source": {
                                            "type": "string",
                                            "example": "重庆青年报",
                                            "description": "新闻来源"
                                        },
                                        "curpage": {
                                            "type": "int",
                                            "example": 1,
                                            "description": "当前页"
                                        },
                                        "description": {
                                            "type": "string",
                                            "example": "近日，四川省苍溪县，大三学生陶青梅放暑假待在家中...",
                                            "description": "新闻描述"
                                        }
                                    }
                                },
                                "example": {
                                    "msg": "success",
                                    "code": 200,
                                    "result": {
                                        "list": [
                                            {
                                                "id": "6010bdf651a5a4ae04511014f2c4bcd6",
                                                "url": "http:\/\/toutiao.com\/group\/6708637225535406606\/",
                                                "ctime": "2019-07-08 05:58:28",
                                                "title": "女子独自一人深夜约见男网友 却被困民房五小时 结果被伤害四次",
                                                "picUrl": "http:\/\/p6-tt.byteimg.com\/list\/tos-cn-i-0000\/9aa800e29be911e9b2977cd30a55d46c",
                                                "source": "经视看天下",
                                                "description": "女子独自一人深夜约见男网友 却被困民房五小时 结果被伤害四次"
                                            },
                                            {
                                                "id": "b0f86b4bb6e755295b9cc1f710fe4132",
                                                "url": "http:\/\/toutiao.com\/group\/6710866210608644619\/",
                                                "ctime": "2019-07-07 18:28:19",
                                                "title": "加州7.1级强震后，数万蜜蜂离奇坠地身亡，尸横遍野，震惊网民",
                                                "picUrl": "http:\/\/p9-tt.byteimg.com\/list\/pgc-image\/RVX52A65Pj0fEF",
                                                "source": "南方都市报",
                                                "description": "7.1级地震发生后，加州居民哈利勒惊恐地发现屋外空地上大批蜜蜂坠地死亡，尸横遍野。在美国加州当地时间6日再次发生7.1级地震之后，加州一位居民在社交媒体上发布视频，显示成千上万的蜜蜂在他家屋外的空地上坠地身亡，可谓“尸横遍野”。"
                                            },
                                            {
                                                "id": "9e6ea240842cd6aefe3e1c735e69bcea",
                                                "url": "http:\/\/toutiao.com\/group\/6710838421994078732\/",
                                                "ctime": "2019-07-07 16:40:29",
                                                "title": "大三女生穿破洞牛仔裤外出，外婆拉着手不让出门",
                                                "picUrl": "http:\/\/p9-tt.byteimg.com\/list\/pgc-image\/7c4efd211ee84a4ca0a2fca99d2e9b95",
                                                "source": "重庆青年报",
                                                "description": "近日，四川省苍溪县，大三学生陶青梅放暑假待在家中，这天她准备和78岁的外婆一起出门逛逛，于是换好了衣服将自己简单地收拾了一下。"
                                            }
                                        ],
                                        "allnum": 2363,
                                        "curpage": 1
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}