Name: Search News API 📰: Quickly Discover Trending News or Articles across the globe 🌎
Brand: skycraft
SKU: api-skycraft-search-news
Availability: InStock
Author: API Market

Shashank

# Search News API 📰
### Overview

Use this endpoint to query a massive collection of news articles from over 200 countries in 90 languages. You can filter by keywords, date range, location, categories, sentiment, etc. The result is a set of articles matching your chosen criteria, including title, text, authors, publish date, and more.

💼 **Provider**: API League 

---

## Features
✅ **Flexible Text Search :** 
 Match words using AND, OR, or exclusion within the title or text. 
✅ **Date Range Filters :** 
Limit results to a specific publish date window. 
✅ **Location & Category :** 
Refine results by geographic radius or predefined categories (e.g., politics, sports). 
✅ **Sentiment Analysis :** 
Filter articles based on sentiment scores within the range `[-1, 1]`. 
✅ **Sorting & Pagination :** 
 Sort by publish date (ascending or descending), skip articles using `offset`, and limit results with `number`.


---

## Use Cases
🔹**Media Monitoring** 
Track brand mentions or news coverage by specifying text and date ranges. 
🔹**Market Intelligence** 
Stay updated on categories like technology or business. 
🔹**Geo-Targeted Articles** 
Retrieve local news by specifying location and radius. 
🔹**Sentiment Tracking** 
Monitor overall negativity or positivity in coverage. 


---

## API Reference

#### 1. Search News

🔹**Query Parameters**:
| Parameter | Type | Example | Description |
|---------------------------|------------------|--------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------|
| **text** | string | tesla | The text to match in the news content (at least 3 characters, maximum 100 characters). Use "OR" to search for any terms, e.g., tesla OR ford. You can also exclude terms by using a minus sign (-), e.g., tesla -ford. |
| **source-countries** | string | us,uk | A comma-separated list of ISO 3166 country codes from which the news should originate. |
| **language** | string | en | The ISO 6391 language code of the news. |
| **min-sentiment** | number($double) | -0.8 | The minimal sentiment of the news in the range [-1,1]. |
| **max-sentiment** | number($double) | 0.8 | The maximal sentiment of the news in the range [-1,1]. |
| **earliest-publish-date** | string | 2022-04-22 16:12:35 | The news must have been published after this date. |
| **latest-publish-date** | string | 2022-04-22 16:12:35 | The news must have been published before this date. |
| **news-sources** | string | https://www.bbc.co.uk | A comma-separated list of news sources from which the news should originate. |
| **authors** | string | John Doe | A comma-separated list of author names. Only news from any of the given authors will be returned. |
| **categories** | string | politics,sports | A comma-separated list of categories. Only news from any of the given categories will be returned. Possible categories: politics, sports, business, technology, entertainment, health, science, lifestyle, travel, culture, education, environment, other. |
| **entities** | string | ORG:Tesla | Filter news by entities (ORG, PER, or LOC). |
| **location-filter** | string | 51.050407, 13.737262, 100 | Filter news by radius around a certain location. Format is "latitude,longitude,radius in kilometers". |
| **sort** | string | publish-time | The sorting criteria (publish-time). |
| **sort-direction** | string | ASC | Whether to sort ascending or descending (ASC or DESC). |
| **offset** | integer($int32) | 0 | The number of news to skip in the range [0,10000]. |
| **number** | integer($int32) | 10 | The number of news to return in the range [1,100]. |
| **x-api-market-key** | string | clusi6tp6ss213414 | API.market API Key. |


🔹**Example Request**:

 ```
curl -X 'GET' \
 'https://prod.api.market/api/v1/apileague/search-news/search-news?text=tesla&source-countries=us%2Cuk&language=en&min-sentiment=-0.8&max-sentiment=0.8&earliest-publish-date=2022-04-22%2016%3A12%3A35&latest-publish-date=2022-04-22%2016%3A12%3A35&news-sources=https%3A%2F%2Fwww.bbc.co.uk&authors=John%20Doe&categories=politics%2Csports&entities=ORG%3ATesla&location-filter=51.050407%2C%2013.737262%2C%20100&sort=publish-time&sort-direction=ASC&offset=0&number=10' \
 -H 'accept: application/json' \
 -H 'x-api-market-key: <your_api_key>'
```

🔹**Response**:
 ```
{
 "offset": 0,
 "number": 10,
 "available": 83,
 "news": [
 {
 "summary": "Tesla CEO Elon Musk has revealed new details...",
 "image": "https://internetprotocol.co/content/images/2021/12/Tesla-to-Release-a-Four-Motor-Version-of-Cybertruck.png",
 "sentiment": 0.712523,
 "language": "en",
 "video": "https://cdn.jwplayer.com/videos/70lDQJpg-RyIcpnTz.mp4",
 "title": "Tesla to Release a Four-Motor Version of Cybertruck",
 "url": "https://internetprotocol.co/hitech/2021/12/07/tesla-to-release-a-four-motor-cybertruck/",
 "source_country": "co",
 "id": 28,
 "text": "Tesla CEO Elon Musk has revealed new details...",
 "category": "business",
 "publish_date": "2022-09-30 01:07:48",
 "authors": [
 "Iwan Stone",
 "Zahna Eklund"
 ]
 }
 ]
}
```
---

## Best Practices 
✅ **Minimum Search Criteria :** Ensure at least one search parameter (e.g., `text` or `language`) is provided to refine queries. 
✅ **Pagination :** Use `offset` and `number` to manage large result sets effectively. 
✅ **Date Validation :** Confirm that `earliest-publish-date` and `latest-publish-date` follow the correct date/time formats. 
✅ **Location Filter :** Format location searches with `latitude,longitude,radius` for accurate results. 
✅ **Sentiment Ranges :** Keep sentiment scores within `[-1,1]` to filter for negative, neutral, or positive news. 
✅ **Sorting :** Use `sort=publish-time` and `sort-direction=ASC|DESC` to control the chronological order of results.


---

## SEO Keywords

🔹 
`news search`, `text-based filtering`, `sentiment filter`, `category-based news`, `location-based news`

🚀 Get Started Today! 

📩 Support Contact: [support@api.market](mailto\:support@api.market)

The Search News API allows users to discover news articles from over 200 countries in 90 languages, filtering results by keywords, date range and location.