【技术文档】公开的实时新闻数据API接口详解
本篇文档详细介绍了一款高效、收费的新闻数据API接口,为广大开发者提供稳定、实时更新的新闻资讯数据。本文不仅包含接口调用说明、计费规则、返回字段解析,同时针对SEO进行了优化,助力您的技术博客或开发平台在搜索引擎中获得更高的排名。
1. 接口简介
本API专为新闻聚合、数据分析及AI应用设计,通过调用接口,开发者可获取最新的新闻数据。接口支持标准调用方式,返回格式为JSON,便于快速集成和二次开发。
核心特点:
- 实时数据更新:默认20分钟刷新一次;充值满1000元VIP用户可享3分钟刷新频率。
- 低成本调用:每次请求仅收取0.01元(需预先充值)。
- 安全便捷:使用微信小程序“数字续坚”签到获取独一无二的调用码,确保接口安全调用。
2. 接口调用地址
接口请求方式为HTTP GET,请求URL格式如下:
GET https://www.xujian.tech/atlapi/data/c/news/latest/{code}
- {code}:开发者需在微信小程序“数字续坚”首页签到后获取,用于验证调用权限。
3. 计费与VIP特权
- 计费标准:每次API请求扣费0.01元,调用前必须预充值。
- VIP加速服务:充值满1000元即可享受数据刷新频率由20分钟降至3分钟的VIP特权。
- 充值与支持:如有任何疑问或需技术支持,请添加微信:
xujian_cq
。
4. 返回示例及字段解析
调用成功时,接口返回示例如下(返回数据示例仅包含一个新闻条目):
{
"code": 200,
"msg": "succeed.",
"data": [
{
"id": "20250227A01O9300",
"articletype": "0",
"title": "特朗普猛烈抨击:欧盟的成立就是为了搞砸美国,将加税25%",
"pic_style": 21001,
"publish_time": "2025-02-27 07:33:14",
"pic_info": { /* 图片信息对象 */ },
"link_info": { /* 链接信息对象 */ },
"media_info": { /* 文章来源信息对象 */ },
"interation_info": { /* 互动数据对象 */ },
"doc_info": { /* 文章分类对象 */ },
"update_time": "2025-02-27 09:47:02",
"rcm_info": { /* 推荐信息对象 */ },
"desc": "【文/观察者网 齐倩】当地时间2月26日,美国总统特朗普举行其第二任期的首次内阁会议...",
"safe_control": { /* 安全控制对象 */ },
"category": { /* 新闻类别对象 */ },
"declare": {},
"pub_info": { /* 出版信息对象 */ },
"payment_info": {},
"user_address": "上海",
"extra_property": {},
"share_info": { /* 分享信息对象 */ }
}
]
}
4.1 顶级字段
字段名 | 类型 | 说明 |
---|---|---|
code | int | 状态码,200表示请求成功 |
msg | string | 返回消息说明,如“succeed.” |
data | array | 新闻数据列表,数组形式返回多个新闻条目 |
4.2 data
数组中各字段详细说明
-
请直接看接口返回内容理解,下方字段解释可能没有及时更新
-
接口返回内容不会经常更新,但有变化的可能
-
id
类型:string
说明:新闻或文章的唯一标识符。 -
articletype
类型:string
说明:文章类型,0
表示新闻,后续可扩展其他类型。 -
title
类型:string
说明:新闻标题,直接反映新闻主要内容,适合SEO关键词布局。 -
pic_style
类型:int
说明:图片展示样式,便于前端根据数值决定显示风格。 -
publish_time
类型:string
说明:发布时间,格式为YYYY-MM-DD HH:MM:SS
,用于数据排序和时间过滤。 -
pic_info
类型:object
说明:包含新闻中相关图片的多个展示尺寸及样式,如大图、小图、三图模式等。详细字段包括:big_img
:大图列表small_img
:小图列表three_img
:三图模式列表ext
:额外图片资源(如196x130、360x240、330x330尺寸)等
-
link_info
类型:object
说明:文章链接相关信息,提供多种链接形式,便于分享及原文访问。主要字段:share_url
:用于社交平台分享的链接url
:原始新闻链接short_url
:短链接形式
-
media_info
类型:object
说明:新闻来源及媒体相关信息,如媒体名称、图标、账号认证信息等。 -
interation_info
类型:object
说明:互动数据,包含评论ID、评论数、阅读量、点赞数、收藏数及分享数等数据,帮助开发者了解用户互动情况。 -
doc_info
类型:object
说明:文章分类信息,标识新闻的一级和二级分类(如政治、国际等),有助于内容过滤和推荐。 -
update_time
类型:string
说明:数据更新时间,格式同publish_time
,用于判断数据的新旧。 -
desc
类型:string
说明:文章摘要,简述新闻核心内容,便于快速预览和搜索引擎抓取关键信息。 -
category
类型:object
说明:进一步细分的新闻类别信息,提供中英文名称及分类ID,适用于分类展示和SEO标签设置。 -
share_info
类型:object
说明:分享相关信息,提供标题和副标题,便于社交媒体及分享平台展示。
其余字段如rcm_info
、safe_control
、declare
、pub_info
、payment_info
、extra_property
等此处不表
5. 开发者必读注意事项
- 安全调用:请勿将获取的
code
分享给他人,确保接口调用安全。 - 请求频率控制:为防止滥用,每个开发者账号均有请求频率限制,请根据实际需求合理调用。
- 数据格式兼容:返回的JSON格式可能会随接口升级有所调整,请做好版本兼容性处理。
- 收费规则:调用前确保账户余额充足,避免因余额不足导致服务中断。
- 技术支持:如遇问题,请及时联系微信:
xujian_cq
获取技术支持与咨询。
6. 总结
本API接口为开发者提供了一种低成本、高效的实时新闻数据调用方式。无论您是进行新闻聚合、数据分析,还是AI数据训练,本接口均可满足需求。欢迎广大开发者试用并反馈意见,共同打造更完善的技术生态。