# News API

> Search for real-time news articles with time range and domain filters.

Source: https://cotera.co/docs/reference/tools/individual-tools/newsapi

---

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

***

## Authentication

To authenticate, you'll need a RapidAPI key for the [Real-Time News Data API](https://rapidapi.com/letscrape-6bRBa3QguO5/api/real-time-news-data/pricing).

**Note:** The free plan includes 100 requests per month.

***

## News Search

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:**

```json
{
  "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