> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# World News API

> The World News API gives you access to thousands of news sources in over 50 languages from over 150 countries.

![World News API logo](https://mintcdn.com/composio-preview/DMB8UrgJmE7r-ZQ5/images/toolkits/world_news_api.svg?fit=max\&auto=format\&n=DMB8UrgJmE7r-ZQ5\&q=85\&s=86ec2a05aec5934abe0b905ec5cbde9d)

* **Category:** web search & research
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 8
* **Triggers:** 0
* **Slug:** `WORLD_NEWS_API`
* **Version:** 20261030\_00

## Tools

> [accordion] Extract News Article
>
> **Slug:** `WORLD_NEWS_API_EXTRACT_NEWS`
>
> Extract structured content from a public article URL. The call costs 2 quota points, plus 2 additional points when analyze is true. Paywalled or login-protected pages may return incomplete content.
>
> #### Input Parameters
>
> **url** `string` *required*
>
> Public HTTP or HTTPS article URL from which to extract content.
>
> **analyze** `boolean`
>
> Whether to also analyze named entities and sentiment. Enabling this adds 2 quota points to the base 2-point extraction cost.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Extract News Links
>
> **Slug:** `WORLD_NEWS_API_EXTRACT_NEWS_LINKS`
>
> Extract article links from a news homepage or section page. The call costs 1 quota point, and an empty link list is a successful result.
>
> #### Input Parameters
>
> **url** `string` *required*
>
> News homepage or section page from which to discover article links.
>
> **prefix** `string`
>
> Only return links beginning with this URL prefix.
>
> **include\_subdomains** `boolean`
>
> Whether to include article links hosted on subdomains of the input site.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Generate RSS Feed
>
> **Slug:** `WORLD_NEWS_API_GENERATE_RSS_FEED`
>
> Generate an RSS 2.0 XML feed from a public news homepage or section URL. Returns raw XML text. The call costs 1 quota point, plus 0.5 points per feed item when extract\_news is true.
>
> #### Input Parameters
>
> **url** `string` *required*
>
> Public HTTP or HTTPS news homepage or section URL to convert into RSS.
>
> **extract\_news** `boolean`
>
> Whether to extract article metadata into feed items. Enabling this adds 0.5 quota points per feed item and may produce no items for unsupported pages.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Geo Coordinates
>
> **Slug:** `WORLD_NEWS_API_GET_GEO_COORDINATES`
>
> Resolve a place name or address to latitude and longitude for use in Search News location\_filter. Costs 1 quota point.
>
> #### Input Parameters
>
> **location** `string` *required*
>
> Place name or address to geocode, for example Tokyo or 10 Downing Street, London.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get News by IDs
>
> **Slug:** `WORLD_NEWS_API_GET_NEWS_BY_IDS`
>
> Retrieve full article records for IDs returned by Search News or Get Top News. Costs 0.1 quota points per returned article.
>
> #### Input Parameters
>
> **ids** `array` *required*
>
> Article IDs to retrieve, usually taken from Search News or Get Top News results. Provide a nonempty list; IDs are sent as one comma-separated query.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Top News
>
> **Slug:** `WORLD_NEWS_API_GET_TOP_NEWS`
>
> Return relevance-ranked top-news clusters for a country, language, and optional date. Costs 1 quota point; Free accounts can request about one month of history.
>
> #### Input Parameters
>
> **date** `string`
>
> News date in YYYY-MM-DD format. Omit it for the current day.
>
> **language** `string` *required*
>
> Two-letter lowercase ISO 639-1 language code spoken in source\_country.
>
> **headlines\_only** `boolean`
>
> Whether to return compact articles containing only id, title, and URL.
>
> **source\_country** `string` *required*
>
> Two-letter lowercase ISO 3166 country code whose news sources should be ranked.
>
> **max\_news\_per\_cluster** `integer`
>
> Maximum number of articles to include in each relevance cluster (1-100).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search News
>
> **Slug:** `WORLD_NEWS_API_SEARCH_NEWS`
>
> Search indexed news articles. Provide at least one anchor filter: text, source country, language, news sources, authors, categories, entities, or location. Date, sentiment, and text-match fields only refine an anchored search. Returns one offset page and costs 1 point plus 0.01 points per returned article; Free accounts can search about one month of history.
>
> #### Input Parameters
>
> **sort** `string`
>
> Sort results by publication time. Without text or both date bounds, this limits the search to the last 31 days.
>
> **text** `string`
>
> Search expression. Supports implicit AND, uppercase OR, parentheses, quoted phrases, and -term exclusion; wildcards are unsupported.
>
> **number** `integer`
>
> Maximum articles to return in this page. Larger pages consume an additional 0.01 quota points per returned article.
>
> **offset** `integer`
>
> Zero-based result offset for this page. Increase by number to request the next page.
>
> **authors** `array`
>
> Restrict results to these author names. Their comma-separated wire value may be at most 300 characters.
>
> **entities** `array`
>
> Restrict results to semantic entities such as ORG:Tesla or PER:Elon Musk.
>
> **language** `string`
>
> Only return articles in this 2-letter ISO 639-1 language.
>
> **categories** `array`
>
> Restrict results to these article categories.
>
> **news\_sources** `array`
>
> Restrict results to at most 10 news source domains or source names.
>
> **max\_sentiment** `number`
>
> Maximum article sentiment score, from -1 (negative) to 1 (positive).
>
> **min\_sentiment** `number`
>
> Minimum article sentiment score, from -1 (negative) to 1 (positive).
>
> **sort\_direction** `string ("ASC" | "DESC")`
>
> Sort direction when sort is set.
>
> **source\_country** `string`
>
> Only return articles published by sources in this 2-letter ISO 3166 country.
>
> **location\_filter** `string`
>
> Restrict results to latitude,longitude,radius\_km with radius 1-100, for example 35.6764,139.6500,25. Use Get Geo Coordinates to resolve a place first.
>
> **text\_match\_indexes** `string ("title" | "content" | "title,content")`
>
> Article fields in which to match text. Only use this when text is provided.
>
> **latest\_publish\_date** `string`
>
> Only include articles published at or before this date/time, as YYYY-MM-DD or YYYY-MM-DD HH:MM:SS.
>
> **earliest\_publish\_date** `string`
>
> Only include articles published at or after this date/time, as YYYY-MM-DD or YYYY-MM-DD HH:MM:SS.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search News Sources
>
> **Slug:** `WORLD_NEWS_API_SEARCH_NEWS_SOURCES`
>
> Search monitored news sources by partial name and report matching source URLs and languages. Costs 1 quota point.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Full or partial news-source name to find.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
