简繁 EN

新时空 API

简介

资讯列表查询

资讯详情查询

新时空 API 接口简介

新時空专注于提供及时、准确的全球财经资讯，包括IPO新股解码、ETF市场分析、科技创新动态以及中国企业出海策略。平台致力于通过人工智能技术，链接全球价值，帮助用户捕捉投资机会和行业趋势。

订阅优势：实时更新每日港股、A股、中概股动态与热点，如新股上市、基石投资者、暗盘、认购倍数和募资额、上市首日表现，保荐人、承销商、律师、审计师等排行榜等关键数据，以及ETF盘中快讯、ETF日报、ETF资金流向等ETF情报。

深度洞见：覆盖生物科技、创新药、区块链、无人驾驶、新能源科技、智能制造、芯片、半导体、机器人、人工智能等前沿领域的实时动态、热门公司、智库报告、行业观察等，基于全球视野提供中文与英文多维度研究报告和排行榜。

新时空 API 提供新闻资讯的查询服务，支持多语言（简体中文、繁体中文、英文）、分类筛选、关键词搜索等功能。API 支持 JSON 和 XML 两种响应格式，通过 format 请求参数指定，Accept 请求头不影响格式。

关键特性

支持批量新闻查询（分页、排序、过滤）。
支持单条或多条新闻详情查询。
多语言支持：zh-cn（简体中文，默认）、zh-hk（繁体中文）、en（英文）。
错误处理：标准 HTTP 状态码和错误消息。
速率限制：如果请求过多，返回 429 错误。

访问权限

新时空 API 接口采用开放访问模式，无需额外的认证步骤，调用者可直接通过接口地址发起请求，实现对接与数据调用。

响应格式

JSON（默认）。
XML（通过 Accept 头或 format 参数指定）。

快速开始（AI Agent / 开发者版）

Base URL: https://www.newtimespace.com。无需注册、无需 API Key，仅支持 GET 请求。

第一次调用，建议带上显式参数：

GET https://www.newtimespace.com/api/v1/article/getArticles?page=1&limit=10&language=zh-cn&format=json

十秒上手（Python）：

import json, urllib.request

raw = urllib.request.urlopen(
        "https://www.newtimespace.com/api/v1/article/getArticles?format=json"
).read()
data = json.loads(raw.decode("utf-8-sig")) # 响应带 UTF-8 BOM，必须用 utf-8-sig 解码for a in data["articles"]:
        print(a["article_id"], a["pubDate"], a["title"])
print(data["pagination"]) # 以 pages 字段作为翻页终止条件

注意：所有响应（JSON、XML、成功与错误响应）均以 UTF-8 BOM（EF BB BF）开头，解析前必须先去除，否则 JSON 解析会报 "Expecting value"。

两个接口，怎么选？

场景	用哪个接口	详细文档（点此跳转）
发现资讯：按标题/标签/分类/日期/语言搜索，分页浏览	资讯列表查询 GET /api/v1/article/getArticles	资讯列表查询文档
已拿到 article_id：按 ID 精确取文、批量取文（一次最多 20 个）、切换语言版本	资讯详情查询 GET /api/v1/article/detail	资讯详情查询文档

场景一：发现资讯

搜索标题包含"人工智能"的简体中文资讯（查询值需 URL 编码）：

GET /api/v1/article/getArticles?title=%E4%BA%BA%E5%B7%A5%E6%99%BA%E8%83%BD&language=zh-cn&format=json

按分类取 ETF 资讯（分类与语言需匹配，见详细文档）：

GET /api/v1/article/getArticles?category=ETF&language=zh-cn&format=json

取某一天发布的英文资讯，每页 20 条：

GET /api/v1/article/getArticles?language=en&date=2026-09-08&limit=20&format=json

返回结构：status + articles数组 + pagination对象。命中多条时按发布时间倒序；搜索无结果时返回 HTTP 200 + 空数组，属正常响应，不要重试。

场景二：获取具体文章

从列表结果中取得 article_id（例如 1444676）后，按 ID 精确取文：

GET /api/v1/article/detail?articleIds=1444676&format=json

返回 status + data，data 为该文章对象（含 title、description、content、pubDate、url 等完整字段）。注意：article_id 必须来自列表接口的真实返回，不要自行构造；传入不存在的 ID 返回 HTTP 200 + "data": []，按"未找到"处理即可。

场景三：一次获取多篇文章

多个 ID 用英文逗号分隔：

GET /api/v1/article/detail?articleIds=1444676,1444675&format=json

单次最多 20 个 ID，超过会返回 400（articleIds cannot exceed 20 items）。需要取更多时拆分为多批，例如 45 个 ID 按 20 + 20 + 5 分三次请求。

注意：批量查询只命中 1 条时 data 是对象而非数组；混入无效 ID 时无效项被跳过、只返回命中文章，data 形态跟随命中数。解析前先判断 data 类型。

Agent 必读：注意事项

响应带 UTF-8 BOM：解析前先去除，推荐用能自动剥离 BOM 的解码方式（如 Python 的 utf-8-sig）。
时间字段为北京时间（GMT+8）：pubDate / date / time 均为北京时间；pubDateTZ 字段值当前固定为 UTC，请勿据此换算，也不要给时间加 8 小时。
响应格式仅由 format 参数决定：请始终显式传 format=json，Accept 请求头不影响响应格式。
空结果是正常响应：搜索无结果、分类与语言组合不匹配、页码越界时，均返回 HTTP 200 + 空数组，不要当作失败重试；翻页以 pagination.pages 为终止条件，不要只读第一页。
详情接口的 data 有两种形态：命中 1 条时为对象，多条时为数组，解析时需同时兼容。
限速：每 IP 每 60 秒 20 次，超限返回 429 并携带 Retry-After 响应头（按其等待后重试）；响应不含剩余额度计数头，Agent 需自行统计请求频率。
仅支持 GET：以 POST 请求会得到 HTTP 200 的纯文本 illegal request.，不是 JSON。