Name: World News – Global Article Search | Free · $6/mo | API.market
Brand: skycraft
SKU: api-skycraft-world-news-api
Availability: InStock
Author: API Market

Shashank Agarwal

# 🌍 📰 World News API Documentation (SEO-Optimized)

Welcome to the **World News API**—your one-stop solution for **global news coverage**, **semantic search**, and **sentiment analysis**. With access to thousands of reputable news sources in 90+ languages from over 228 countries, the World News API makes it effortless to discover, filter, and analyze **breaking news** and **historical headlines**. Integrate seamlessly through the **API Market** to power real-time or retrospective insights in your applications.

---

## Overview 

1. **Massive International Coverage**  
   - Pull in articles from thousands of sources around the globe, spanning 90+ languages and 228+ countries.  
   - Retrieve both *real-time breaking news* and deep *historical archives*.

2. **Semantic Tagging & Advanced Search**  
   - Automatically tag articles with **locations**, **organizations**, and **people** for precise filtering.  
   - Write complex Boolean queries (e.g., text includes “tesla” OR “elon musk” -“spacex”) to target exactly what you need.

3. **Sentiment Analysis**  
   - Each piece of content has a numeric sentiment score from -1 (negative) to +1 (positive).  
   - Quickly isolate stories by negativity or positivity, ideal for brand monitoring or opinion tracking.

4. **Newspaper Front Pages**  
   - Access daily front pages from 6,000+ newspapers across 125 countries.  
   - Perfect for visual snapshots of today’s most pressing headlines.

5. **Geo-Targeted News**  
   - Filter results by distance (radius in kilometers) from specific coordinates.  
   - Ideal for hyperlocal or regional news monitoring.

6. **Historical & Time-Based Insights**  
   - Search by date ranges to pinpoint coverage before or after significant events.  
   - Compare sentiment or volume of articles year over year, month over month, or any custom timeframe.

---

## Example Quick Start: Search News

Use the **API Market** endpoint to integrate easily. Below is a sample **GET** request to search for Tesla-related news published in the US, in English, within a specific time range and sentiment window:

```bash
curl -X 'GET' \
  'https://api.magicapi.dev/api/v1/spoonacular/world-news-api/search-news?text=tesla&source-country=us&language=en&min-sentiment=-0.8&max-sentiment=0.8&earliest-publish-date=2024-04-22%2016%3A12%3A35&latest-publish-date=2025-01-22%2016%3A12%3A35&news-sources=https%3A%2F%2Fwww.bloomberg.com&categories=politics%2Csports%2Ctechnology&entities=ORG%3ATesla&sort=publish-time&sort-direction=ASC&offset=0&number=10' \
  -H 'accept: application/json' \
  -H 'x-magicapi-key: YOUR_API_MARKET_KEY'
```

**Parameters**  
- `text=tesla`: Looks for articles referencing the keyword “tesla.”  
- `source-country=us`: Limits coverage to U.S.-based outlets.  
- `language=en`: Retrieves articles in English.  
- `min-sentiment` & `max-sentiment`: Narrow sentiment score between -0.8 and 0.8.  
- `earliest-publish-date` & `latest-publish-date`: Searches between April 22, 2024, and January 22, 2025.  
- `news-sources=https://www.bloomberg.com`: Filters to Bloomberg.  
- `categories=politics,sports,technology`: Limits coverage to specified categories.  
- `entities=ORG:Tesla`: Ensures “Tesla” is recognized as an organization.  
- `sort=publish-time, sort-direction=ASC`: Sorts results by time in ascending order.  
- `offset=0, number=10`: Returns the first 10 results.

---

## Major Endpoints

Leverage these core endpoints to tailor your news experience:

1. **Search News** — `GET /search-news`  
   - **Description**: Perform robust, keyword-based searches with filters for language, country, sentiment range, categories, entities, and more.  
   - **Key Parameters**: `text`, `source-country`, `language`, `min-sentiment`, `max-sentiment`, `earliest-publish-date`, `latest-publish-date`, `news-sources`, `categories`, `entities`, `location-filter`, `sort`, `sort-direction`, `offset`, `number`.  
   - **Use Case**: Ideal for **comprehensive media monitoring** and **brand tracking**.

2. **Top News** — `GET /top-news`  
   - **Description**: Fetch **top headlines** from a specified country and language, optionally for a given date.  
   - **Key Parameters**: `source-country`, `language`, `date`, `headlines-only`.  
   - **Use Case**: Quickly **highlight major events** or trending articles within a region.

3. **Retrieve Newspaper Front Page** — `GET /retrieve-front-page`  
   - **Description**: Access real-time or historical front pages from thousands of newspapers around the world.  
   - **Key Parameters**: `source-country`, `source-name`, `date`.  
   - **Use Case**: Showcase **today’s headlines at a glance** or **analyze historical coverage**.

4. **Retrieve News Articles by IDs** — `GET /retrieve-news`  
   - **Description**: Fetch detailed info (title, text, authors, images, etc.) for specific articles by IDs.  
   - **Key Parameters**: `ids` (comma-separated).  
   - **Use Case**: Retrieve **full article data** after collecting article IDs from your search results.

5. **Extract News** — `GET /extract-news`  
   - **Description**: Convert any news article URL into structured JSON, including metadata like images, videos, sentiment, etc.  
   - **Key Parameters**: `url`, `analyze`.  
   - **Use Case**: Automate **content extraction** for data pipelines or private indexing.

6. **Extract News Links** — `GET /extract-news-links`  
   - **Description**: Scrape links from a given news webpage.  
   - **Key Parameters**: `url`, `analyze`.  
   - **Use Case**: **Spider content** or discover related stories from a single article or landing page.

7. **News Website to RSS Feed** — `GET /feed.rss`  
   - **Description**: Generate an RSS feed from any news website page.  
   - **Key Parameters**: `url`, `analyze`.  
   - **Use Case**: **Keep track of updates** on sites that don’t offer native RSS capabilities.

8. **Get Geo Coordinates** — `GET /geo-coordinates`  
   - **Description**: Convert a city/address into latitude/longitude for location-based filters.  
   - **Key Parameters**: `location`.  
   - **Use Case**: Precisely **narrow your news search** by area radius (geofencing).

---

## Best Practices for Integration

1. **Caching**  
   - Cache frequent queries to reduce API usage and improve performance.

2. **Rate Limits**  
   - Plan for possible 429 (“Too Many Requests”) responses, especially if you’re scaling quickly.

3. **Validate Parameters**  
   - Use valid ISO codes for countries (`source-country`) and languages (`language`), or results may be sparse.

4. **Pagination**  
   - Combine `offset` and `number` to handle large result sets smoothly.

5. **Security**  
   - Keep your `x-magicapi-key` confidential; only use it in secure server-side code.

---

The **World News API** is built for **developers, data scientists, and media analysts** seeking unparalleled coverage of global events. By combining **semantic tagging**, **sentiment scoring**, and **comprehensive filters**, you can create advanced media monitoring systems, track brand perception worldwide, or analyze historical shifts in public opinion.

**Get Started Now**:
1. Visit the [API Market Listing](https://api.market/store/spoonacular/world-news-api) to obtain your `x-magicapi-key`.  
2. Start with the `GET /search-news` endpoint for instant insights.  
3. Explore advanced features like **front-page retrieval**, **geo-filters**, or **RSS generation**.  
4. Scale confidently while keeping an eye on best practices like caching and rate-limit handling.

**Stay ahead of the headlines** with the **World News API**—the global news aggregator designed for maximum reach, reliability, and relevance in your applications.

Search real-time & historical news from 228+ countries. 90+ languages supported. Free 500 calls/mo, from $6/mo. Start free on API.market.

World News – Global Article Search | Free · $6/mo | API.market

FREE