Skip to main content
Control which websites appear in search results, filter by date and location, target specific languages, and fine-tune search behavior using Sonar API filters.

Domain Filters

Control which websites are included or excluded from search results using search_domain_filter. Supports both domain-level and URL-level filtering. Key parameters:
  • search_domain_filter: Array of domains or URLs (max 20)
  • Allowlist mode: Include only specified domains (no prefix)
  • Denylist mode: Exclude domains (prefix with -)
You can add a maximum of 20 domains or URLs. Use either allowlist OR denylist mode, not both simultaneously.

Date & Time Filters

Filter search results by publication date, last updated date, or recency using date range parameters. Key parameters:
  • search_after_date_filter: Filter by publication date (format: %m/%d/%Y)
  • search_before_date_filter: Filter by publication date (format: %m/%d/%Y)
  • last_updated_after_filter: Filter by last updated date
  • last_updated_before_filter: Filter by last updated date
  • search_recency_filter: Predefined periods ("hour", "day", "week", "month", "year")
Date filters must use %m/%d/%Y format (e.g., "3/1/2025"). search_recency_filter cannot be combined with other date filters. Use hour for real-time data such as breaking news or live events.

Location Filters

Customize search results based on geographic location using user_location within web_search_options. Key parameters:
  • country: Two-letter ISO 3166 country code (required with coordinates)
  • region: State, province, or administrative division
  • city: City name
  • latitude: Latitude coordinate (-90 to 90)
  • longitude: Longitude coordinate (-180 to 180)
For best accuracy, provide as many location fields as possible. City and region significantly improve location precision.

Language Filter

Filter search results by language using ISO 639-1 language codes. Key parameters:
  • search_language_filter: Array of 2-letter language codes (max 10)
Language codes must be valid ISO 639-1 codes (e.g., "en", "fr", "de"). You can filter by up to 10 languages per request.

Academic Filter

Prioritize scholarly sources and peer-reviewed content by setting search_mode to "academic". Key parameters:
  • search_mode: Set to "academic" to target academic sources
Date filters are not supported with search_mode="academic" and are silently ignored. This includes search_after_date_filter, search_before_date_filter, search_recency_filter, last_updated_after_filter, and last_updated_before_filter. To narrow academic results by date, include the desired time range directly in your query text (e.g., “findings on neural networks since 2023”).

SEC Filings Filter

Target U.S. Securities and Exchange Commission filings and official financial documents. Key parameters:
  • search_mode: Set to "sec" to target SEC filings

Context Size Control

Control how much search context is retrieved to balance cost and comprehensiveness. Key parameters:
  • search_context_size: Set to "low" (default), "medium", or "high" within web_search_options
Selecting "high" increases search costs due to more extensive web retrieval. Use "low" when cost efficiency is critical.

Search Control

Control when web search is performed using the search classifier or by disabling search entirely. Key parameters:
  • enable_search_classifier: Let AI decide when to search (boolean)
  • disable_search: Disable web search completely (boolean)
Pricing remains the same regardless of whether search is triggered. Search control is for performance optimization, not cost reduction.

Combining Filters

You can combine multiple filters for precise control over search results:

Next Steps

Sonar Quickstart

Get started with the Sonar API and learn the basics