- Category: web search & research
- Auth: API_KEY
- Composio-managed OAuth available? N/A
- Tools: 4
- Triggers: 0
- Slug:
NEWS_API - Version: 20261014_00
Tools
Get Everything
Get Everything
Slug:
NEWS_API_GET_EVERYTHINGTool 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.Input Parameters
Newest date or date-time for articles (YYYY-MM-DD or YYYY-MM-DDThh:mm:ss). Date range limits depend on your News API plan tier (free plans are limited to approximately 1 month of historical data)
Oldest date or date-time for articles (YYYY-MM-DD or YYYY-MM-DDThh:mm:ss). Date range limits depend on your News API plan tier (free plans are limited to approximately 1 month of historical data)
Page number of results to return (default 1) When totalResults exceeds pageSize, increment page to retrieve additional results.
Order to sort articles: relevancy, popularity, or publishedAt
Comma-separated list of source identifiers to filter on Use valid source IDs from NEWS_API_GET_SOURCES; unrecognized IDs silently return empty results.
string ("ar" | "de" | "en" | "es" | "fr" | "he" | "it" | "nl" | "no" | "pt" | "ru" | "sv" | "ud" | "zh")
2-letter ISO-639-1 code to restrict the search to that language
Output
Get Sources
Get Sources
Slug:
NEWS_API_GET_SOURCESTool 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.Input Parameters
string ("ae" | "ar" | "at" | "au" | "be" | "bg" | "br" | "ca" | "ch" | "cn" | "co" | "cu" | "cz" | "de" | "eg" | "fr" | "gb" | "gr" | "hk" | "hu" | "id" | "ie" | "il" | "in" | "is" | "it" | "jp" | "kr" | "lt" | "lv" | "ma" | "mx" | "my" | "ng" | "nl" | "no" | "nz" | "ph" | "pl" | "pt" | "ro" | "rs" | "ru" | "sa" | "se" | "sg" | "si" | "sk" | "th" | "tr" | "tw" | "ua" | "us" | "ve" | "za")
Filter sources by this country code.
Filter sources by this news category.
string ("ar" | "de" | "en" | "es" | "fr" | "he" | "it" | "nl" | "no" | "pt" | "ru" | "se" | "ud" | "zh")
Filter sources by this language code.
Output
Get Top Headlines
Get Top Headlines
Slug:
NEWS_API_GET_TOP_HEADLINESTool 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.Input Parameters
Keywords or phrase to search for in the article title and body. At least one of ‘country’, ‘category’, ‘sources’, or ‘q’ must be provided.
string ("ae" | "ar" | "at" | "au" | "be" | "bg" | "br" | "ca" | "ch" | "cn" | "co" | "cu" | "cz" | "de" | "eg" | "fr" | "gb" | "gr" | "hk" | "hu" | "id" | "ie" | "il" | "in" | "it" | "jp" | "kr" | "lt" | "lv" | "ma" | "mx" | "my" | "ng" | "nl" | "no" | "nz" | "ph" | "pl" | "pt" | "ro" | "rs" | "ru" | "sa" | "se" | "sg" | "si" | "sk" | "th" | "tr" | "tw" | "ua" | "us" | "ve" | "za")
2-letter ISO 3166-1 code of the country to get headlines for. At least one of ‘country’, ‘category’, ‘sources’, or ‘q’ must be provided. Cannot be used with ‘sources’.
Comma-separated list of source identifiers to include (max 20). At least one of ‘country’, ‘category’, ‘sources’, or ‘q’ must be provided. Cannot be combined with ‘country’ or ‘category’. Use valid source IDs from NEWS_API_GET_SOURCES; unrecognized IDs may silently return empty results.
News category to filter by. At least one of ‘country’, ‘category’, ‘sources’, or ‘q’ must be provided. Cannot be used with ‘sources’.
Output
Get V1 Articles
Get V1 Articles
Slug:
NEWS_API_GET_V1_ARTICLESTool 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.Input Parameters
The identifier for the news source or blog you want headlines from. Use the /sources endpoint to locate this.