POST /v1/web/news finds news articles about a query and returns them newest first. Every article comes with the outlet that published it and when it was published, and each link points at the publisher’s own page. Turn on scrapeResults and each article also comes back read as clean data.
When to use it
- You track announcements: funding rounds, acquisitions, launches, leadership changes, layoffs.
- You want what happened this week about a company or a topic, not the pages that rank best for it.
- You feed an agent that needs dated sources it can cite.
Example request
Example response
Writing a good query
- For one company, search its name on its own. News sources match the words you send. “Acme raises funding round” brings back general funding stories from English outlets, and they can push the company’s own coverage out. “Acme” alone returns the articles that name it, and you can pick the funding ones from their titles.
- Write the name the way its own press does. A Chinese or Korean company is covered under its Chinese or Korean name. If you want one kind of event, add the word for it in that language, such as 融资 or 투자, not the English word.
- Use
timeRangefor recency. Do not put a month or a year into the query. - For a topic across companies, describe the event, such as
startup raises series Aorappoints chief executive.
Key options
What to find news about, like
acme raises funding or appoints chief executive. Up to 500 characters.Only articles published within this window before now:
hour, day, week or month.ISO 3166 alpha-2 country code (for example
us, gb, in) to lean results toward that country’s coverage.The oldest earlier answer to the same search you will accept, in milliseconds. By default we reuse an answer up to 5 minutes old for
hour, 15 for day and 30 for week or month. Set 0 to always search fresh.When
true, each article also comes back with its page read and returned as clean data, at 1 extra credit per article read.How to read each article, using the same options as Scrape. Ignored when
scrapeResults is false.Response fields
ok when articles were found, no_results when none matched in the window. If news cannot be searched at all, the request fails with a 503 rather than returning an empty list.Articles, newest first. Each has
title, url (the publisher’s own page), source (the outlet), publishedAt, snippet and data: the article read as clean data when scrapeResults is on, otherwise null.publishedAt is exact when the listing gives a time. Some listings only say how long ago an article appeared, such as “2 days ago”, and then publishedAt is worked out from that, so it can be off by up to that unit. An article listed more than once comes back once; when several outlets cover the same story, each outlet’s article is its own result.
Billing
A news search costs 1 credit, and a search that finds nothing is free. WithscrapeResults on, each article actually read costs 1 more, the same as scraping that page directly.
Related
Search
Search the whole web rather than the news.
Jobs
See who is hiring, alongside what they announced.
Credits
How every call is priced.
API Reference
Full
POST /v1/web/news schema and a live playground.