News API is a simple HTTP REST API for searching and retrieving live articles from all over the web.
Toolkit · news_api
v1
01Get Everythingtool
02Get Sourcestool
03Get Top Headlinestool
04Get V1 Articlestool
API Key · verified
4T · 0TR
newsapi
Supported tools and triggers
Each tool is a typed function your agent can call. Each trigger fires an agent run when something changes upstream.
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.
TOOL
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.
TOOL
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.
TOOL
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.
