API de noticias Fastmarkets
Guía del usuario de integración de la API de noticias
Table of Contents
API de noticias
La API de Noticias proporciona contenido de noticias Fastmarkets y datos de referencia relacionados . La función de búsqueda integrada permite filtrar datos y recuperar artículos históricos. Todos los artículos tienen un ID único, título, resumen breve y contenido asociados.
Documentación técnica de la API
Para obtener más información sobre la especificación de esta API, consulte la página de documentación de la API de noticias (Swagger)
Puedes intentar ejecutar llamadas API reales allí con tus credenciales de la plataforma Fastmarkets . Solicita al equipo Fastmarkets que te proporcione acceso a Swagger.
Autenticación
Todas las API Fastmarkets requieren un token de acceso válido para recuperar datos con permisos. Para generar un token de acceso, consulte la guía de la API de autenticación con el alcance: fastmarkets.news.api fastmarkets.search.api.
El token se añade a un parámetro del encabezado de autorización con el prefijo "Bearer". Por ejemplo:
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdjZTkyOTQ4NDk0ODRkMDM4YzQ
Instancia de artículo
El objeto Article, devuelto por la API de noticias, tiene los siguientes campos incluidos:
| Nombre | Tipo | Descripción |
|---|---|---|
| id | string | ID único del artículo. Puede incluir letras. |
| title | sring | El titular del artículo |
| content | string | Texto completo del artículo en formato HTML. Puede incluir hipervínculos a otros artículos o páginas de precios relacionadas, así como URLs que apuntan a imágenes incrustadas en el artículo. El formato puede variar según la fuente, pero el HTML es simple y no incluye componentes anidados ni diseños complejos. |
| summary | string | Una breve descripción del artículo |
| authors | List[string] | Lista de nombres de autores |
| AuthorsDetails | List[authorDetail] | Lista de detalles de los autores: nombre y correo electrónico |
| publishingDate | Fecha AAAA-MM-DDThh:mm:ss+00:00 | Marca de tiempo de publicación original |
| updatedDate | Fecha AAAA-MM-DDThh:mm:ss+00:00 | Marca de tiempo de la última modificación |
| requestFields | List[string] | Metadatos opcionales si se solicitan (por ejemplo, ubicaciones, productos relacionados) |
Ejemplo de contenido:
<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 <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 <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."Ejemplo de detalles del autor:
"authorsDetails": [
{
"name": "Jessica Zong",
"email": "jessica.zong@fastmarkets.com"
}
]Ejemplo de campos adicionales:
"commodities": [
"Iron ore",
"Ferrous ores"
],
"locations": [
"Asia",
"China",
. . .
"Greater China",
"Northeast Asia"
]Ejemplo de fecha:
2023-12-07T09:40:00+00:00Buscar noticias
Este método permite recuperar un conjunto de artículos con información detallada mediante filtros. El parámetro "FromDate" es obligatorio y debe ser una fecha válida en formato AAAA-MM-DD. La respuesta contendrá la lista de objetos de artículo y el número total de artículos filtrados.
El objeto del artículo en la respuesta de búsqueda contiene toda la información básica del artículo: identificación única, título, resumen, contenido, fecha de publicación y actualización e información de los autores.
Ejemplo de solicitud (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-10url = "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)Ejemplo de respuesta (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
}En caso de que el número total de resultados filtrados sea mayor que el tamaño del fragmento de artículos, puede paginar a través de la selección de búsqueda utilizando Desde y Tamaño:
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=300Tenga en cuenta que los valores en los parámetros de la matriz filtran la solicitud mediante la operación 'or': la solicitud inferior devolverá artículos que contienen información para América del Norte o 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=300Opciones de filtrado disponibles:
| Campo | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Commodity | Array[string] | La definición del filtro para el producto básico | steel |
Location |
Array[String] |
La definición del filtro para la ubicación |
Asia |
Product |
Array[string] |
La definición del filtro para el producto |
Germania dioxide, corn oil |
Source |
Array[string] |
La definición del filtro para la fuente |
AgriCensus, Fastmarkets Metals |
FromDate * (obligatorio) |
Date string aaaa-mm-dd |
Fecha de inicio de la serie temporal |
2023-10-12 |
ToDate |
Date string aaaa-mm-dd |
Fecha de finalización de la serie temporal |
2024-12-26 |
From |
Integer |
El índice inicial para la paginación |
0 |
Size |
Integer |
El número de resultados que se incluirán en la respuesta |
150 |
Fields |
Array[string] |
Campo(s) opcional(es) para devolver en la respuesta. |
Commodities, locations, Source, Products, ArticleTypes, PublicationURLs |
Recuperación de artículo por ID
Este método permite recuperar información detallada del artículo mediante su identificador único. El parámetro "Ids" es obligatorio y debe ser una lista válida de IDs de artículos proporcionada por la API de búsqueda. Se pueden solicitar varios artículos en una sola solicitud proporcionando varios IDs separados por una coma. La respuesta contendrá el objeto del artículo con su título, contenido, resumen, autor, fecha de publicación , fecha de actualización y campos adicionales, si se proporcionaron en la solicitud.
Ejemplo de solicitud (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)Ejemplo de respuesta (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"
]
}
]
}Recuperación de datos de referencia
El endpoint References es útil para obtener detalles de todos los valores válidos para un campo en particular (como nombres de empresas) o para obtener el nombre completo de un valor de referencia específico, utilizado para el endpoint de Búsqueda.
Los siguientes datos de referencia están disponibles:
- Commodity
- Location
- Source
- Product
- Topic
- Company
Ejemplo de solicitud (Python):
GET /news/v3/References HTTP/1.1
Host: api.fastmarkets.com
Content-Type: application/x-www-form-urlencoded
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdjZTkyOTQ4NDk0ODRkMDM4YzQ
Types=Locationurl = "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)Ejemplo de respuesta (JSON):
{
"References": [
{
"Type": "location",
"Items": [
"APEC",
"ASEAN",
"Afghanistan",
"Africa",
"Alabama",
. . .
"Uzbekistan",
"Vietnam",
"West Coast United States",
"Western Europe",
"World",
"Zambia"
]
}
]
}Información técnica de la API
Para obtener más información sobre nuestras API, consulte la información técnica de la API.
Más ayuda
Si tiene más preguntas o necesita más ayuda, consulte todo el contenido de ayuda disponible en nuestro Hub de Soporte.
Si no encuentra lo que necesita y desea contactar nuestros equipos de soporte, le ayudaremos.