{
"openapi": "3.0.0",
"info": {
"title": "足球新闻 - API文档",
"version": "1.0.0",
"description": "国足新闻资讯，国足明星动态等。如需获得欧洲足球五大联赛资讯，请使用网页转API<\/a>接口。在必填参数urlid中的值为242新闻类接口功能扩展，混合全频道数据使用综合新闻<\/a>接口、按频道分类输出使用分类新闻<\/a>接口。本接口仅限用于内部数据分析和机器学习，不得用于终端展示。（MCP 服务由 分类新闻 接口统一提供）"
},
"servers": [
{
"url": "https:\/\/apis.tianapi.com"
}
],
"paths": {
"\/football\/index": {
"get": {
"summary": "查询新闻列表",
"tags": [
"足球新闻"
],
"description": "默认返回10条最新资讯支持翻页和关键词搜索",
"parameters": [
{
"name": "key",
"in": "query",
"description": "API密钥",
"required": true,
"schema": {
"type": "string",
"description": "API密钥"
}
},
{
"name": "num",
"in": "query",
"description": "返回数量1-50，默认10",
"required": true,
"schema": {
"type": "int",
"example": 10,
"description": "返回数量1-50，默认10"
}
},
{
"name": "form",
"in": "query",
"description": "兼容历史问题，建议传1",
"required": false,
"schema": {
"type": "int",
"example": 0,
"description": "兼容历史问题，建议传1"
}
},
{
"name": "page",
"in": "query",
"description": "翻页",
"required": false,
"schema": {
"type": "int",
"example": 1,
"description": "翻页"
}
},
{
"name": "rand",
"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": "62ac899e8fcf654a74479b4239b4651f",
"description": "新闻唯一ID"
},
"url": {
"type": "string",
"example": "https:\/\/www.tianapi.com\/article\/154",
"description": "文章地址"
},
"ctime": {
"type": "Date",
"example": "2015-07-17",
"description": "发布时间"
},
"title": {
"type": "string",
"example": "文章的标题",
"description": "文章标题"
},
"allnum": {
"type": "int",
"example": 625,
"description": "结果数"
},
"picUrl": {
"type": "string",
"example": "https:\/\/www.tianapi.com\/static\/img\/logo.png",
"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": "3a2863eae4a49d268e040a6a28b44297",
"url": "https:\/\/sports.sina.com.cn\/china\/national\/2021-02-04\/doc-ikftssap3345892.shtml",
"ctime": "2021-02-04 15:00",
"title": "阿兰有希望赶上国足与亚泰热身赛这一周意义重大",
"picUrl": "https:\/\/sports.sina.com.cn\/\/n.sinaimg.cn\/front20210204ac\/667\/w1400h867\/20210204\/4f9b-kirmait8501207.jpg",
"source": "新浪足球",
"description": "新浪足球"
},
{
"id": "bc4928a7abbecba9b4801c4842106672",
"url": "https:\/\/sports.sina.com.cn\/china\/national\/2021-02-04\/doc-ikftssap3169583.shtml",
"ctime": "2021-02-04 10:00",
"title": "阿兰首次进国足先与李铁沟通参加5日热身希望不大",
"picUrl": "https:\/\/sports.sina.com.cn\/\/n.sinaimg.cn\/sports\/transform\/282\/w650h432\/20210204\/2eda-kirmait7407659.jpg",
"source": "新浪足球",
"description": "新浪足球"
},
{
"id": "13695ca24bec9301019e1cc1b9033a0a",
"url": "https:\/\/sports.sina.com.cn\/china\/national\/2021-02-04\/doc-ikftpnny4127021.shtml",
"ctime": "2021-02-04 09:00",
"title": "未来可期!阿兰秀中文印证其聪明将成李铁手中王牌",
"picUrl": "https:\/\/sports.sina.com.cn\/\/n.sinaimg.cn\/sports\/transform\/283\/w650h433\/20210204\/3093-kirmait7248944.jpg",
"source": "新浪足球",
"description": "新浪足球"
}
],
"allnum": 500,
"curpage": 1
}
}
}
}
}
}
},
"post": {
"summary": "查询新闻列表",
"tags": [
"足球新闻"
],
"description": "默认返回10条最新资讯支持翻页和关键词搜索",
"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"
},
"form": {
"type": "int",
"example": 0,
"description": "兼容历史问题，建议传1"
},
"page": {
"type": "int",
"example": 1,
"description": "翻页"
},
"rand": {
"type": "int",
"example": 1,
"description": "随机获取"
},
"word": {
"type": "string",
"example": "天行数据",
"description": "检索关键词"
}
},
"required": [
"key",
"num"
]
}
}
}
},
"responses": {
"200": {
"description": "成功响应",
"content": {
"application\/json": {
"schema": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "62ac899e8fcf654a74479b4239b4651f",
"description": "新闻唯一ID"
},
"url": {
"type": "string",
"example": "https:\/\/www.tianapi.com\/article\/154",
"description": "文章地址"
},
"ctime": {
"type": "Date",
"example": "2015-07-17",
"description": "发布时间"
},
"title": {
"type": "string",
"example": "文章的标题",
"description": "文章标题"
},
"allnum": {
"type": "int",
"example": 625,
"description": "结果数"
},
"picUrl": {
"type": "string",
"example": "https:\/\/www.tianapi.com\/static\/img\/logo.png",
"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": "3a2863eae4a49d268e040a6a28b44297",
"url": "https:\/\/sports.sina.com.cn\/china\/national\/2021-02-04\/doc-ikftssap3345892.shtml",
"ctime": "2021-02-04 15:00",
"title": "阿兰有希望赶上国足与亚泰热身赛这一周意义重大",
"picUrl": "https:\/\/sports.sina.com.cn\/\/n.sinaimg.cn\/front20210204ac\/667\/w1400h867\/20210204\/4f9b-kirmait8501207.jpg",
"source": "新浪足球",
"description": "新浪足球"
},
{
"id": "bc4928a7abbecba9b4801c4842106672",
"url": "https:\/\/sports.sina.com.cn\/china\/national\/2021-02-04\/doc-ikftssap3169583.shtml",
"ctime": "2021-02-04 10:00",
"title": "阿兰首次进国足先与李铁沟通参加5日热身希望不大",
"picUrl": "https:\/\/sports.sina.com.cn\/\/n.sinaimg.cn\/sports\/transform\/282\/w650h432\/20210204\/2eda-kirmait7407659.jpg",
"source": "新浪足球",
"description": "新浪足球"
},
{
"id": "13695ca24bec9301019e1cc1b9033a0a",
"url": "https:\/\/sports.sina.com.cn\/china\/national\/2021-02-04\/doc-ikftpnny4127021.shtml",
"ctime": "2021-02-04 09:00",
"title": "未来可期!阿兰秀中文印证其聪明将成李铁手中王牌",
"picUrl": "https:\/\/sports.sina.com.cn\/\/n.sinaimg.cn\/sports\/transform\/283\/w650h433\/20210204\/3093-kirmait7248944.jpg",
"source": "新浪足球",
"description": "新浪足球"
}
],
"allnum": 500,
"curpage": 1
}
}
}
}
}
}
}
}
}
}