# NewsAPI

News API is a simple HTTP REST API for searching and retrieving live articles from all over the web.

- **Category:** news & lifestyle
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 4
- **Triggers:** 0
- **Slug:** `NEWS_API`
- **Version:** 20260407_00

## Tools

### Get Everything

**Slug:** `NEWS_API_GET_EVERYTHING`

Tool to search through every article published by over 150,000 sources. At least one of q, sources, language, or domains must be set or the API returns a parametersMissing error. Historical date range depends on your News API plan tier (free plans limited to ~1 month). No country parameter exists; target geography via sources, domains, or country-specific terms in q. Burst requests may trigger HTTP 429; apply backoff on throttling errors.

### Get Sources

**Slug:** `NEWS_API_GET_SOURCES`

Tool to fetch available news sources. Use when you need to retrieve a list of publishers by optional filters like category, language, or country. Source IDs returned here are the only valid IDs for filtering in NEWS_API_GET_EVERYTHING or NEWS_API_GET_TOP_HEADLINES — unrecognized IDs cause silently empty results.

### Get Top Headlines

**Slug:** `NEWS_API_GET_TOP_HEADLINES`

Tool to retrieve live top and breaking headlines; does not support historical or date-bounded queries (use NEWS_API_GET_EVERYTHING for past date ranges). Results favor major outlets; use NEWS_API_GET_EVERYTHING or COMPOSIO_SEARCH_WEB for niche publications. Use when you need current headlines filtered by country, category, source(s), or keywords.

### Get V1 Articles

**Slug:** `NEWS_API_GET_V1_ARTICLES`

Tool to fetch live article metadata from a news source using the legacy v1 API. Use when you need headlines from a specific source identifier. This v1 endpoint has been superseded by /v2/top-headlines.