Overview
Thegrok_news_search tool provides specialized search capabilities for news and current events. In comprehensive mode, it offers timeline analysis, direct quotes from sources, and multiple perspectives on news events.
Parameters
The news search query. Must be a non-empty string with a maximum length of 1000 characters.
Analysis depth and format. Must be one of:
basic- Returns simple news results with titles, snippets, and URLscomprehensive- Provides detailed analysis with timelines, direct quotes from sources, multiple perspectives, and verification status
basicNote: Comprehensive mode is particularly powerful for news, providing timeline analysis and perspective comparison.Maximum number of news results to return.Constraints:
- Minimum: 1
- Maximum: 20
- Default: 10
Optional start date for search in ISO8601 format (YYYY-MM-DD). Limits search to content from this date onwards.Validation:
- Must match pattern:
^\d{4}-\d{2}-\d{2}$ - Must be a valid calendar date
- Must be before or equal to
to_dateif both are provided
2025-01-01Note: Especially useful for news to filter by time period.Optional end date for search in ISO8601 format (YYYY-MM-DD). Limits search to content up to this date.Validation:
- Must match pattern:
^\d{4}-\d{2}-\d{2}$ - Must be a valid calendar date
- Must be after or equal to
from_dateif both are provided
2025-12-31Request Examples
Response Format
Basic Mode Response
Comprehensive Mode Response
Error Response
Common Error Messages
Search query must be a non-empty string- Query parameter is missing or emptySearch query too long (max 1000 characters)- Query exceeds maximum lengthfrom_date must be in ISO8601 format (YYYY-MM-DD)- Invalid date formatfrom_date is not a valid date- Invalid calendar date (e.g., 2025-02-30)from_date must be before or equal to to_date- Invalid date rangeAPI service is not healthy - missing XAI_API_KEY- API key not configured
Usage Notes
- Content Focus: Optimized for news articles and current events
- Recency: Prioritizes the most recent information
- Date Filtering: Particularly useful for news to narrow time periods
- Timeline Analysis: Comprehensive mode provides chronological event analysis
- Verification: Comprehensive mode includes fact verification status
- Perspectives: Multiple viewpoints on news events in comprehensive mode
- Performance: Basic mode provides faster responses than comprehensive mode
- Caching: Comprehensive analyses are cached for 30 minutes
- Token Usage: Basic mode uses ~2000 tokens, comprehensive mode uses ~4000 tokens
- Best For: Breaking news, current events, policy developments, and trending topics
When to Use Comprehensive Mode
Comprehensive mode is particularly valuable for news when you need:- Timeline of events showing how a story developed
- Direct quotes from key figures and sources
- Multiple perspectives on controversial topics
- Verification status of claims and facts
- Deep analysis of implications and stakeholders
- Context and background information