cotera
Logo

News API

Authentication Type: API Key
Description: Search for real-time news articles with time range and domain filters.

Search and filter news articles by time range and domain.

Search News Articles

Search for news articles with time range filters (last hour, day, week, month, year) and optional domain filtering.

Operation Type: Query (Read)

Parameters:

  • query string (required): Search query for news articles
  • timePublished string (required): Time range for news search. Options: "anytime", "1h", "1d", "7d", "1y"
  • source string (nullable): Optional source domain filter (e.g., cnn.com, bbc.com)
  • limit number (nullable): Maximum number of articles to return (default: 50, max: 500)
  • country string (nullable): Country code filter (e.g., US, GB, CA)
  • lang string (nullable): Language code filter (e.g., en, es, fr)

Returns:

  • status string: Response status
  • request_id string: Unique request identifier
  • data array of objects: Array of news articles
    • title string: Article title
    • link string: Article URL
    • snippet string (nullable): Article snippet/description
    • photo_url string (nullable): Article main image URL
    • thumbnail_url string (nullable): Article thumbnail URL
    • published_datetime_utc string: Publication date and time in UTC
    • authors array of strings: Array of article authors
    • source_url string: Source website URL
    • source_name string: Source name
    • source_logo_url string (nullable): Source logo URL
    • source_favicon_url string (nullable): Source favicon URL
    • source_publication_id string (nullable): Source publication identifier
    • related_topics array of objects: Array of related topics
      • topic_id string: Topic identifier
      • topic_name string: Topic name

Example Usage:

{
  "query": "artificial intelligence technology trends",
  "timePublished": "7d",
  "source": "techcrunch.com",
  "limit": 25,
  "country": "US",
  "lang": "en"
}

Common Use Cases

News Monitoring:

  • Track breaking news and developments in specific industries or topics
  • Monitor competitor mentions and market developments with targeted search queries
  • Set up automated news alerts by searching for specific keywords and time ranges

Content Research:

  • Gather recent articles from trusted sources for research and content creation
  • Find news articles with specific time constraints for timely blog posts and reports
  • Search for trending topics and stories within defined geographic regions

Market Intelligence:

  • Monitor industry news and regulatory changes that could impact business operations
  • Track competitor announcements and strategic moves through targeted source filtering
  • Analyze news sentiment and coverage patterns across different publications and regions

Media Analysis:

  • Collect articles from specific news sources for media bias analysis and comparison
  • Study news coverage patterns across different countries and languages
  • Analyze topic relationships and trending themes through related topics data