API de notícias

A API de Notícias fornece conteúdo de notícias Fastmarkets e dados de referência relacionados . A função de busca integrada permite filtrar dados e recuperar artigos antigos. Todos os artigos possuem um ID único, título, breve resumo e conteúdo associados.

Documentação técnica da API

Para obter mais detalhes sobre as especificações desta API, consulte a página de documentação da API de Notícias (Swagger).

Você pode tentar executar chamadas de API reais usando suas credenciais da plataforma Fastmarkets . Solicite à equipe Fastmarkets que conceda acesso ao Swagger à sua conta.

Autenticação

Todas as APIs Fastmarkets exigem um token de acesso válido para recuperar dados protegidos por permissões. Para gerar um token de acesso, consulte o guia da API de autenticação com o escopo: fastmarkets.news.api fastmarkets.search.api.

O token é então adicionado a um parâmetro de cabeçalho de Autorização usando o prefixo 'Bearer'. Por exemplo:

Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdjZTkyOTQ4NDk0ODRkMDM4YzQ

Instância de artigo

O objeto Article, retornado pela API de Notícias, inclui os seguintes campos:

Exemplo de conteúdo:

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

Exemplo de detalhes do autor:

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

Exemplo de campos adicionais:

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

Exemplo de data:

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

Buscar notícias

Este método permite recuperar um conjunto de artigos com informações detalhadas, filtrando-os. O parâmetro “FromDate” é obrigatório e deve ser uma data válida no formato AAAA-MM-DD. A resposta conterá a lista de objetos de artigo e o número total de artigos filtrados.

O objeto do artigo na resposta da pesquisa contém todas as informações básicas do artigo: ID único, título, resumo, conteúdo, data de publicação e atualização e informações sobre os autores.

Exemplo de solicitação (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)

Exemplo de resposta (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
}

Caso o número total de resultados filtrados seja maior que o tamanho do bloco de artigos, você pode paginar a seleção da pesquisa usando os campos "De" e "Tamanho".

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

Observe que os valores nos parâmetros da matriz filtram a solicitação pela operação 'ou': a solicitação na parte inferior retornará artigos que contêm informações para a América do Norte ou para a Ásia:

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

Opções de filtragem disponíveis:

Recuperando artigo por ID

Este método permite recuperar informações detalhadas de um artigo através de seu identificador único. O parâmetro “Ids” é obrigatório e deve ser uma lista válida de IDs de artigos fornecidos pela API de Busca. Vários artigos podem ser consultados em uma única requisição, fornecendo diversos IDs separados por vírgula. A resposta conterá o objeto do artigo com seu título, conteúdo, resumo, autor, data de publicação , data de atualização e campos adicionais, caso tenham sido fornecidos na requisição.

Exemplo de solicitação (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)

Exemplo de resposta (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"
            ]
        }
    ]
}

Campos opcionais para dados do artigo

Ao solicitar artigos, nem todos os dados disponíveis associados a um artigo são retornados por padrão. Isso é intencional para ajudar a reduzir o tamanho da resposta ao solicitar uma grande quantidade de registros.

No entanto, esses dados adicionais podem ser retornados usando o parâmetro de entrada `Fields`. Aqui está uma lista dos campos opcionais disponíveis que podem ser adicionados à solicitação:

• prioridade - valor que representa a classificação de uma notícia de destaque, de 1 (mais alta) a 4 (mais baixa), para artigos prioritários;
• commodities - lista de mercadorias mencionadas ou relacionadas ao artigo;
• locais - lista de locais mencionados ou relacionados ao artigo;
• Produtos - lista de locais mencionados ou relacionados ao artigo;
• fonte - fonte do artigo Fastmarkets (ex.: Fastmarkets Metals);
• publishedBy - detalhes da editora. Campo obsoleto, geralmente duplicando o valor do campo Autores;
• relatedResourceUris - lista de recursos Fastmarkets (instrumento de preço ou link de notícias), mencionados no artigo (ex.: physical://instrument/AG-PLM-0032 , news://article/cb96a624-f7f1-4733-9d92-19cf11c19265 )
• Tópicos - lista de tópicos da Fastmarkets nos quais o artigo foi publicado (por exemplo, Inteligência de Mercado, Notícias do Setor)

Recuperação de dados de referência

O endpoint References é útil para obter detalhes de todos os valores válidos para um campo específico (como nomes de empresas) ou para obter o nome completo de um valor de referência específico, usado no endpoint Search.

Os seguintes dados de referência estão disponíveis:

• Commodity
• Localização
• Fonte
• Produto
• Tópico
• Empresa

Exemplo de solicitação (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)

Exemplo de resposta (JSON):

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

Informações técnicas da API

Para saber mais sobre nossas APIs, consulte as informações técnicas da API .

Ajuda adicional

Se você tiver mais perguntas ou precisar de suporte adicional, consulte todo o conteúdo de ajuda disponível em nosso Hub de suporte.
Se você não encontrar o que precisa e quiser contatar nossas equipes de suporte, então vamos ajudá-lo(a).