News API

Follow the news about any company or topic.

A headline is a pointer. The article is the data.

Ask for a company or a topic and get the recent articles, newest first, each with its outlet and the time it was published. When a headline is not enough, the same call returns the full articles as clean text.

Get API key
POST /v1/web/news200
querybattery storage
windowlast week
articles returned6
outlets6
newest17 Nov, 00:01
credits1

newest first · every article dated

[ 01 / How it works ]

One query. Dated articles back.

Following the news by hand means a feed per outlet and a filter per company. Here the question is the input, and what comes back already carries who published it and when.

Ask

Name the company or the topic

One call returns the recent articles, newest first. Each carries its headline, its outlet, the time it was published and a short excerpt.

const { results } = await hf.news(
  'battery storage',
);

Narrow

Keep the window and the sources you trust

Set how far back to look, lean results toward a country, and include or exclude sites. The filters are parameters, so nothing has to be squeezed into the query.

await hf.news(topic, {
  timeRange: 'week',
  includeDomains: outlets,
});

Read

Get the full article when a headline is not enough

Ask for the results to be read and each article comes back as clean text in the same response, ready to summarise or to quote with its source.

await hf.news(topic, {
  scrapeResults: true,
});

[ 02 / The demo ]

A week of coverage on one topic, from one call.

This is a real response. Six articles from six outlets on three continents, ordered by the time each was published.

"battery storage" · last weekPOST /v1/web/news6 articles · 1 credit
  • Renewables Now17 Nov, 00:01Poland's battery storage market projected to reach 8.1 GW by 2030 - ModoPoland's battery energy storage market is projected to reach 2.8 GW by the end of 2028, 8.1 GW by 2030 and almost 18 GW by 2040, according to Modo Energy, a London-based data and analytics company for ...
  • pv magazine India16 Nov, 22:45Havells unveils battery energy storage systemsHavells India showcased its battery energy storage systems (BESS) at the REI Expo 2026, highlighting its energy storage solutions as part of its broader renewable energy portfolio, which also includes ...
  • South China Morning Post16 Nov, 21:38Squeezed in the US, China’s CATL bets on Argentina’s battery storage boomWorld’s largest cell maker opens Buenos Aires office to target mines and Patagonian wind farms as Bank of China offers yuan loans.
  • Robotics & Automation News16 Nov, 15:01Powering Automated Sites Without Oversizing: What Battery Storage Brings to Peak-Heavy OperationsAutomated facilities have an unusual power profile. Robots, conveyors, charging stations and handling equipment draw modest power most of the time, then spike when several systems start together.
  • Electrek16 Nov, 13:42Adding wind cuts solar + battery storage power costs nearly 20%Wind and solar fill each other’s gaps, making reliable clean power cheaper and reducing the amount of battery storage needed.
  • Solar Power World15 Nov, 16:00Soneil Spark introduces its Mobile Battery Energy Storage SystemThis week, Soneil Spark rolls out its Mobile Battery Energy Storage System (Mobile BESS), the portable, modular battery storage built into a towable ...

captured from the live API on 2026-11-17 · published between 15 Nov, 16:00 and 17 Nov, 00:01 UTC

Every row has a source and a time. That is what lets a model say where a claim came from and how old it is. Run the same call for each company you follow, on a schedule, and you have a dated feed per account without maintaining a single outlet integration.

[ 03 / Built for ]

Teams who need to know what happened this week.

Anyone whose next step depends on something a company announced, raised, launched or was reported to have done.

Sales teams

The reason to call an account this week is in the news, not the CRM.

A search per account surfaces the funding, launch or hire to open with.

Agent builders

A model asked about last week answers from what it learned last year.

Give it the tool and it reads the coverage, then cites outlet and date.

Market monitoring

Tracking a sector means watching dozens of outlets nobody has time for.

One topic search returns the week across all of them, already ordered.

Risk and compliance

Adverse coverage of a counterparty turns up after the decision is made.

Scheduled searches per name put new coverage in front of a reviewer.

Briefings

A weekly digest is assembled by hand from tabs and forwarded links.

Search, read the articles in the same call, and summarise from the text.

Investor research

Portfolio news arrives from founders late, or not at all.

A dated feed per company, with the outlet named on every item.

[ 04 / Questions ]

What people ask about the news API.

Recent news articles about a query, newest first. Each result has the headline, the address, the outlet that published it, the time it was published and a short excerpt. Ask for the results to be read and each one also carries the full article as clean text.

A news search costs 1 credit, and a search that finds nothing is free. Reading the full articles costs 1 credit more per article read.

Search for the company name and set a time window such as the last day or week. To keep only coverage from outlets you trust, pass their sites as included domains. To follow many companies, run one search per company on a schedule.

Results are ordered by publish time, newest first, and each one states when it was published. By default a search for the last hour accepts an answer up to five minutes old, and you can require a fresh search on every call.

Yes. News is available as an MCP tool as well as over the API, so an agent in Claude, ChatGPT or Cursor can look up what happened recently and cite the outlet and publish time for each article.

[ 05 / Keep going ]

Same API. Other problems.

[ Start ]

Clean web data is one call away.

500 free credits, no card required. Failures are never billed.

Success rate

 

Median scrape

 ms