Skip to main content
Search real-time news with date and country filtering. News mode is tuned for current events, breaking stories, and journalism - available on every plan.

​
What you can do

Media monitoring

Track coverage across topics, brands, and competitors.

Current events

Up-to-the-minute news on any subject, with date filtering.

Region targeting

Focus on specific markets with ISO country codes.

Up to 100 results

Broad coverage per query with the increased_max_results permission.

​
Quick start

Set search_type="news" and add start_date / end_date and country_code to focus. 
from valyu import Valyu

valyu = Valyu()  # uses VALYU_API_KEY from env

response = valyu.search(
    query="artificial intelligence regulation updates",
    search_type="news",
    max_num_results=20,
    start_date="2025-01-01",
    end_date="2025-12-31",
    country_code="US",
)

for r in response["results"]:
    print(r.get("publication_date", "N/A"), "-", r["title"])

import { Valyu } from "valyu-js";

const valyu = new Valyu(); // uses VALYU_API_KEY from env

const response = await valyu.search({
  query: "artificial intelligence regulation updates",
  searchType: "news",
  maxNumResults: 20,
  startDate: "2025-01-01",
  endDate: "2025-12-31",
  countryCode: "US",
});

response.results.forEach(r =>
  console.log(`${r.publicationDate || "N/A"} - ${r.title}`)
);

curl -X POST https://api.valyu.ai/v1/search \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "query": "artificial intelligence regulation updates",
    "search_type": "news",
    "max_num_results": 20,
    "start_date": "2025-01-01",
    "end_date": "2025-12-31",
    "country_code": "US"
  }'
Use ISO 3166-1 alpha-2 country codes: US, GB, DE, FR, and so on.

​
Up to 100 results

News mode supports up to 100 results per query with the increased_max_results permission. Without it, the default maximum is 20.
1

Request the permission

Go to API Key Management and request increased_max_results.
2

Create a new key

After approval, create a new API key and pass max_num_results up to 100.

​
Build a news monitoring agent

Wire Valyu into an AI agent for news and media monitoring with date and region filters.

Open in Cursor

​
Best practices

  1. Filter by date - set start_date / end_date for time-sensitive queries.
  2. Target regions - use country_code to focus on a market.
  3. Go broad when needed - request 100 results with the increased_max_results permission.
  4. Mix in web - use search_type="all" when you need news plus general context.
  5. Automate digests - for recurring monitoring, build a DeepResearch Workflow instead of re-issuing queries by hand.

​
Next steps

Search quickstart

Learn the basics of the Search API.

Date filtering

Advanced date filtering options.

Python SDK

Full Python SDK documentation.

TypeScript SDK

Full TypeScript SDK documentation.