Skip to main content
This example builds a news monitoring system that searches for recent articles on specific topics, filters by date and source, and collects results for processing.

Complete example

How it works

  1. intent=news forces news-specific results rather than general web search
  2. dateRange=24h limits results to the past 24 hours
  3. News array — when the intent is news, results may appear in the news array alongside results
  4. Multiple topics — loop through topics to monitor several areas at once

Variations

Restrict to trusted sources

Limit results to specific publications:

Exclude aggregators

Remove noisy domains from results:

Custom date range

Search a specific time window:

Scheduled monitoring

Run searches on a schedule using cron or a task scheduler:
When running scheduled searches, respect your rate limits. Space requests out and use the X-RateLimit-Remaining header to monitor usage.

Next steps

Filtering

Domain, date, and content filtering options.

Research assistant

Multi-query search with result aggregation.

Rate limits

Rate limit configuration and handling.

Response format

Response structure and result types.