News API

The News API provides Fastmarkets news content and related reference data. The built-in search function allows you to filter data and retrieve historical articles. All articles have associated unique ID, title, short summary and content.

API technical documentation

For more on the specification of this API please refer to the News API documentation page (Swagger)

You can try running real API calls there using your Fastmarkets Platform credentials. Ask Fastmarkets team to provide your account with Swagger access.

Authenticating

All Fastmarkets APIs require a valid Access Token to retrieve permissioned data. To generate an Access Token, please refer to the Authentication API guide. The token is then added to an Authorization header parameter using the ‘Bearer’ prefix. For example:

Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdjZTkyOTQ4NDk0ODRkMDM4YzQ

Article instance

The Article object, returned by News API, have the next fields included:

Content example:

<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."

Author details example:

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

Additional fields example:

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

Date example:

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

Search for news

This method allows retrieving set of articles with detailed article information by filters. The “FromDate” parameter is required and must be a valid date in YYYY-MM-DD format. The response will contain the list of article objects and the total number of filtered articles.

The article object in search response contain all basic article information: unique id, title, summary, content, published and updated date and authors information.

Example Request (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)

Example Response (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
}

In case if total number of filtered results is more, than size of articles chunk, you can paginate through the search selection using From and 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

Please note that values at array parameters filter the request by ‘or’ operation: the bottom request will return articles that contain information for North America or for Asia:

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

Available filtering options:

Retrieving Article by ID

This method allows retrieving detailed article information by its unique identifier. The “Ids” parameter is required and must be a valid list of article IDs provided by Search API. Multiple articles can be asked in a single request by providing several IDs separated by a comma character. The response will contain the article object with its title, content, summary, author, published date, updated date and additional fields if they were provided in the request.

Example Request (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)

Example Response (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"
            ]
        }
    ]
}

Retrieving Reference data

The References endpoint is useful for obtaining details of all valid values for a particular field (such as company names) or to obtain the full name a specific reference value, used for Search endpoint. 

The following reference data is available:

• Commodity
• Location
• Source
• Product
• Topic
• Company

Example Request (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)

Example Response (JSON):

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

Technical API information

To find out more about our APIs please see API technical information