Home

Fastmarkets新闻 API

新闻 API 集成用户指南

+ More

Table of Contents

新闻 API API技术文档认证文章实例搜索新闻请求示例（Python）：响应示例（JSON）：通过 ID 获取文章请求示例（Python）：响应示例（JSON）：获取参考数据请求示例（Python）：响应示例（JSON）： API技术信息更多帮助

新闻 API

新闻 API 提供Fastmarkets新闻内容及相关参考数据。内置搜索功能允许您筛选数据并获取历史文章。所有文章均包含唯一 ID、标题、简短摘要和正文。

API技术文档

有关此 API 的详细说明，请参阅新闻 API 文档页面（Swagger）。

您可以尝试使用Fastmarkets平台登录凭证运行真实的 API 调用。请联系Fastmarkets团队，获取您帐户的 Swagger 访问权限。

认证

所有Fastmarkets API 都需要有效的访问令牌（Access Token）才能获取授权数据。要生成访问令牌，请参阅身份验证 API 指南，范围为： fastmarkets.news.api fastmarkets.search.api。

然后，该令牌会通过“Bearer”前缀添加到授权标头参数中。例如：

Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdjZTkyOTQ4NDk0ODRkMDM4YzQ

文章实例

新闻 API 返回的 Article 对象包含以下字段：

名称	类型	描述
id	string	文章唯一标识符。可能包含字母
title	string	文章标题
content	string	文章全文的HTML格式。可能包含指向其他文章或相关价格页面的超链接，以及指向文章中嵌入图片的URL。格式可能因来源而异，但HTML代码简洁，不包含嵌套组件或复杂布局。
summary	string	文章简要概述
authors	List[string]	作者姓名列表
authorsDetails	List[authorDetail]	作者详情列表 - 姓名和邮箱
publishedDate	Date YYYY-MM-DDThh:mm:ss+00:00	原始发布时间戳
updatedDate	Date YYYY-MM-DDThh:mm:ss+00:00	最后修改时间戳
requested fields	List[string]	可选元数据（如需要）（例如，位置、产品相关信息）

内容示例：

<strong>Domestic<br>\r\n</strong>\r\nFastmarkets' daily price assessment for <a href=\"https://dashboard.fastmarkets.com/p/MB-STE-0152\" target=\"_blank\" data-uri=\"physical://instrument/MB-STE-0152\">steel reinforcing bar (rebar) domestic, ex-whs Eastern China</a> was 3,940-3,960 yuan ($551-554) per tonne on Thursday, up by 20 yuan per tonne from 3,920-3,940 yuan per tonne on Wednesday. <br>\r\n&nbsp;<br>\r\nRising raw materials prices pushed up rebar futures contract prices, sources said. <br>\r\n<br>\r\nThe most-traded May iron ore futures contract on the Dalian Commodity Exchange closed at 952 yuan per tonne on Thursday, up by 22 yuan per tonne from Wednesday. 
. . .
End users will reduce their procurement tonnages if I raise prices too much. Some sellers offer at 3,970-3,980 yuan per tonne, but hardly conclude deals. I can get stable rebar sales volumes by raising prices carefully,\" a trader in Shanghai said.   <br>\r\n<br>\r\n<strong>Billet<br>\r\n</strong>\r\nFastmarkets' daily <a href=\"https://dashboard.fastmarkets.com/p/MB-STE-0157\" target=\"_blank\" data-uri=\"physical://instrument/MB-STE-0157\">price assessment for steel billet domestic, exw Tangshan, Northern China</a> was 3,660 yuan per tonne including value-added tax on Thursday, up by 40 yuan per tonne from Wednesday.             <br>\r\n&nbsp;<br>\r\n<strong>Shanghai Futures Exchange<br>\r\n</strong>\r\nThe most-traded May rebar futures contract closed at 4,011 yuan per tonne on Thursday, up by 58 yuan per tonne from 3,953 yuan per tonne on Wednesday."

作者详情示例：

"authorsDetails": [
                {
                    "name": "Jessica Zong",
                    "email": "jessica.zong@fastmarkets.com"
                }
            ]

其他字段示例：

"commodities": [
                "Iron ore",
                "Ferrous ores"
            ],
"locations": [
                "Asia",
                "China",
                . . .
                "Greater China",
                "Northeast Asia"
            ]

日期示例：

2023-12-07T09:40:00+00:00

搜索新闻

此方法允许通过筛选条件获取包含详细信息的文章集。 “FromDate”参数为必填项，且必须是 YYYY-MM-DD 格式的有效日期。响应将包含文章对象列表和筛选后的文章总数。

搜索结果中的文章对象包含所有基本文章信息：唯一标识符（unique id）、标题（title）、摘要（summary）、内容（content）、发布（published）和更新日期（updated date）以及作者信息（authors information）。

请求示例（Python）：

GET /news/v3/Articles/Search HTTP/1.1
Host: api.fastmarkets.com
Content-Type: application/x-www-form-urlencoded
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdjZTkyOTQ4NDk0ODRkMDM4YzQ

Commodity=steel&FromDate=2025-10-10

url = "https://api.fastmarkets.com/news/v3/Articles/Search?FromDate=2025-10-10&Commodity=steel"
payload = {}
headers = {
	'Authorization': 'Bearer ' + accessToken.access_token,
	'cache-control': 'no-cache'
	}
req = requests.request("GET", url, headers=headers, data = query)
singlePrice = json.loads(req.content)

响应示例（JSON）：

{
    "articles": [
        {
            "id": "5241327",
            "title": "Chinese HRC prices continue . . . 'anti-involution' push",
            "publishedDate": "2025-10-29T10:34:00+00:00",
            "updatedDate": "2025-10-29T10:32:38.547+00:00",
            "summary": "Chinese hot-rolled . . . sources told Fastmarkets.",
            "content": "Futures prices . . .Tuesday</a>.<br>",
            "authors": [
                "Zihuan Pan"
            ],
            "authorsDetails": [
                {
                    "name": "Zihuan Pan",
                    "email": "zihuan.pan@fastmarkets.com"
                }
            ]
        },
	. . .
        {
            "id": "5241331",
            "title": "China's domestic . . . raw materials costs",
            "publishedDate": "2025-10-29T09:29:00+00:00",
            "updatedDate": "2025-10-29T09:30:19.287+00:00",
            "summary": "China's domestic rebar prices . . .Fastmarkets.\r\n",
            "content": "The price rise . . . yuan per tonne on Tuesday.",
            "authors": [
                "Jessica Zong"
            ],
            "authorsDetails": [
                {
                    "name": "Jessica Zong",
                    "email": "jessica.zong@fastmarkets.com"
                }
            ]
        }
    ],
    "total": 246
}

如果筛选出的结果总数超过单个文章块的容量，您可以通过“From”和“Size”选项来分页浏览搜索结果：

GET /news/v3/Articles/Search HTTP/1.1
Host: api.fastmarkets.com
Content-Type: application/x-www-form-urlencoded
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdjZTkyOTQ4NDk0ODRkMDM4YzQ

Commodity=steel&FromDate=2024-10-10&From=100&Size=100

https://api.fastmarkets.com/news/v3/Articles/Search?FromDate=2025-08-10&Commodity=steel&size=100&from=300

请注意，数组参数中的值通过“or”运算对请求进行筛选：底部的请求将返回包含北美或亚洲信息的文章：

GET /news/v3/Articles/Search HTTP/1.1
Host: api.fastmarkets.com
Content-Type: application/x-www-form-urlencoded
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdjZTkyOTQ4NDk0ODRkMDM4YzQ

Commodity=steel&Location=North%20America%2CAsia&FromDate=2024-10-10&From=100&Size=100

https://api.fastmarkets.com/news/v3/Articles/Search?Location=North%20America%2CAsia&FromDate=2025-08-10&Commodity=steel&size=100&from=300

可用的筛选选项：

字段	类型	描述	例子
Commodity	Array[string]	商品的筛选定义	steel
Location	Array[string]	位置的筛选定义	Asia
Product	Array[string]	产品的筛选定义	Germania dioxide, corn oil
Source	Array[string]	源的筛选定义	AgriCensus, Fastmarkets Metals
FromDate* (required)	Date string yyyy-mm-dd	时间序列的起始日期	2023-10-12
ToDate	Date string yyyy-mm-dd	时间序列的结束日期	2024-12-26
From	Integer	分页的起始索引	0
Size	Integer	响应中包含的结果数量	150
Fields	Array[string]	响应中要返回的可选字段。	Commodities, Locations, Source, Products, ArticleTypes, PublicationURIs

通过 ID 获取文章

此方法允许通过文章的唯一标识符检索详细的文章信息。 “Ids”参数为必填项，且必须是搜索 API 提供的有效文章 ID 列表。您可以通过提供多个 ID（以逗号分隔）在单个请求中请求多篇文章。响应将包含文章对象，其中包含标题、内容、摘要、作者、发布日期、更新日期以及请求中提供的其他字段（如有）。

请求示例（Python）：

GET /news/v3/Articles HTTP/1.1
Host: api.fastmarkets.com
Content-Type: application/x-www-form-urlencoded
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdjZTkyOTQ4NDk0ODRkMDM4YzQ

Ids=5187416&Fields=commodities,locations,source,products

url = "https://api.fastmarkets.com/news/v1/Articles?Ids=5187416&Fields=commodities,locations,cource,products"
payload = {}
headers = {
	'Authorization': 'Bearer ' + accessToken,
	'cache-control': 'no-cache'
	}
req = requests.request("GET", url, headers=headers, data = query)
singlePrice = json.loads(req.content)

响应示例（JSON）：

{
    "articles": [
        {
            "id": "5187416",
            "title": "China's domestic . . . raw material costs",
            "publishedDate": "2023-12-07T09:40:00+00:00",
            "updatedDate": "2023-12-07T09:39:10.003+00:00",
            "summary": "China's domestic rebar . . . same day, sources said.\r\n",
            "content": "<strong>Domestic<br>\r\n. . . per tonne on Wednesday.",
            "authors": [
                "Jessica Zong"
            ],
            "authorsDetails": [
                {
                    "name": "Jessica Zong",
                    "email": "jessica.zong@fastmarkets.com"
                }
            ],
            "commodities": [
                "Iron ore",
                "Ferrous ores"
            ],
            "locations": [
                "Asia",
                "China",
                . . .
                "Northeast Asia"
            ],
            "products": [
                "Steel Rebar",
                "Steel billet",
                "Steel Raw Materials"
            ]
        }
    ]
}

获取参考数据

References 端点可用于获取特定字段（例如公司名称）的所有有效值的详细信息，或获取特定参考值的完整名称，用于 Search 端点。

以下参考数据是可用的：

Commodity（商品）
Location（地点）
Source（来源）
Product（产品）
Topic（话题）
Company（公司）

请求示例（Python）：

GET /news/v3/References HTTP/1.1
Host: api.fastmarkets.com
Content-Type: application/x-www-form-urlencoded
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdjZTkyOTQ4NDk0ODRkMDM4YzQ

Types=Location

url = "https://api.fastmarkets.com/news/v3/References?referenceTypes=Location"
payload = {}
headers = {
	'Authorization': 'Bearer ' + accessToken,
	'cache-control': 'no-cache'
	}
req = requests.request("GET", url, headers=headers, data = query)
singlePrice = json.loads(req.content)

响应示例（JSON）：

{
    "References": [
        {
            "Type": "location",
            "Items": [
                "APEC",
                "ASEAN",
                "Afghanistan",
                "Africa",
                "Alabama",
	. . .
                "Uzbekistan",
                "Vietnam",
                "West Coast United States",
                "Western Europe",
                "World",
                "Zambia"
            ]
        }
    ]
}

API技术信息

如需了解更多关于我们 API 的信息，请参阅API 技术信息。

Fastmarkets新闻 API

Contact Us

新闻 API

API技术文档

认证

文章实例

搜索新闻

请求示例（Python）：

响应示例（JSON）：

通过 ID 获取文章

请求示例（Python）：

响应示例（JSON）：

获取参考数据

请求示例（Python）：

响应示例（JSON）：

API技术信息

更多帮助

Related Articles