简繁 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。