Skip to main content
World News API logo
  • 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

Slug: WORLD_NEWS_API_EXTRACT_NEWSExtract 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

string
required
Public HTTP or HTTPS article URL from which to extract content.
boolean
Whether to also analyze named entities and sentiment. Enabling this adds 2 quota points to the base 2-point extraction cost.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WORLD_NEWS_API_GENERATE_RSS_FEEDGenerate 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

string
required
Public HTTP or HTTPS news homepage or section URL to convert into RSS.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WORLD_NEWS_API_GET_GEO_COORDINATESResolve a place name or address to latitude and longitude for use in Search News location_filter. Costs 1 quota point.

Input Parameters

string
required
Place name or address to geocode, for example Tokyo or 10 Downing Street, London.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WORLD_NEWS_API_GET_NEWS_BY_IDSRetrieve full article records for IDs returned by Search News or Get Top News. Costs 0.1 quota points per returned article.

Input Parameters

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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WORLD_NEWS_API_GET_TOP_NEWSReturn 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

string
News date in YYYY-MM-DD format. Omit it for the current day.
string
required
Two-letter lowercase ISO 639-1 language code spoken in source_country.
boolean
Whether to return compact articles containing only id, title, and URL.
string
required
Two-letter lowercase ISO 3166 country code whose news sources should be ranked.
integer
Maximum number of articles to include in each relevance cluster (1-100).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WORLD_NEWS_API_SEARCH_NEWSSearch 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

string
Sort results by publication time. Without text or both date bounds, this limits the search to the last 31 days.
string
Search expression. Supports implicit AND, uppercase OR, parentheses, quoted phrases, and -term exclusion; wildcards are unsupported.
integer
Maximum articles to return in this page. Larger pages consume an additional 0.01 quota points per returned article.
integer
Zero-based result offset for this page. Increase by number to request the next page.
array
Restrict results to these author names. Their comma-separated wire value may be at most 300 characters.
array
Restrict results to semantic entities such as ORG:Tesla or PER:Elon Musk.
string
Only return articles in this 2-letter ISO 639-1 language.
array
Restrict results to these article categories.
array
Restrict results to at most 10 news source domains or source names.
number
Maximum article sentiment score, from -1 (negative) to 1 (positive).
number
Minimum article sentiment score, from -1 (negative) to 1 (positive).
string ("ASC" | "DESC")
Sort direction when sort is set.
string
Only return articles published by sources in this 2-letter ISO 3166 country.
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.
string ("title" | "content" | "title,content")
Article fields in which to match text. Only use this when text is provided.
string
Only include articles published at or before this date/time, as YYYY-MM-DD or YYYY-MM-DD HH:MM:SS.
string
Only include articles published at or after this date/time, as YYYY-MM-DD or YYYY-MM-DD HH:MM:SS.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WORLD_NEWS_API_SEARCH_NEWS_SOURCESSearch monitored news sources by partial name and report matching source URLs and languages. Costs 1 quota point.

Input Parameters

string
required
Full or partial news-source name to find.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not