world
World News. Global news data.
Parameters
- standard
- benzinga
- biztoc
- fmp
- intrinio
- tiingo
start_date: date | None | str
Start date of the data, in YYYY-MM-DD format. The default is 2 weeks ago.
end_date: date | None | str
End date of the data, in YYYY-MM-DD format. The default is today.
limit: int | None
The number of data entries to return. The number of articles to return.
start_date: date | None | str
Start date of the data, in YYYY-MM-DD format. The default is 2 weeks ago.
end_date: date | None | str
End date of the data, in YYYY-MM-DD format. The default is today.
limit: int | None
The number of data entries to return. The number of articles to return.
date: date | None | str
A specific date to get data for.
display: Literal['headline', 'abstract', 'full'] | None
Default: full
Specify headline only (headline), headline + teaser (abstract), or headline + full body (full).
updated_since: int | None
Number of seconds since the news was updated.
published_since: int | None
Number of seconds since the news was published.
sort: Literal['id', 'created', 'updated'] | None
Default: created
Key to sort the news by.
order: Literal['asc', 'desc'] | None
Default: desc
Order to sort the news by.
isin: str | None
The ISIN of the news to retrieve.
cusip: str | None
The CUSIP of the news to retrieve.
channels: str | None
Channels of the news to retrieve.
topics: str | None
Topics of the news to retrieve.
authors: str | None
Authors of the news to retrieve.
content_types: str | None
Content types of the news to retrieve.
start_date: date | None | str
Start date of the data, in YYYY-MM-DD format. The default is 2 weeks ago.
end_date: date | None | str
End date of the data, in YYYY-MM-DD format. The default is today.
limit: int | None
The number of data entries to return. The number of articles to return.
term: str | None
Search term to filter articles by. This overrides all other filters.
source: str | None
Filter by a specific publisher. Only valid when filter is set to source.
start_date: date | None | str
Start date of the data, in YYYY-MM-DD format. The default is 2 weeks ago.
end_date: date | None | str
End date of the data, in YYYY-MM-DD format. The default is today.
limit: int | None
The number of data entries to return. The number of articles to return.
topic: Literal['fmp_articles', 'general', 'press_releases', 'stocks', 'forex', 'crypto'] | None
Default: general
The topic of the news to be fetched.
page: int | None
Page number of the results. Use in combination with limit.
start_date: date | None | str
Start date of the data, in YYYY-MM-DD format. The default is 2 weeks ago.
end_date: date | None | str
End date of the data, in YYYY-MM-DD format. The default is today.
limit: int | None
The number of data entries to return. The number of articles to return.
source: Literal['yahoo', 'moody', 'moody_us_news', 'moody_us_press_releases'] | None
The source of the news article.
sentiment: Literal['positive', 'neutral', 'negative'] | None
Return news only from this source.
language: str | None
Filter by language. Unsupported for yahoo source.
topic: str | None
Filter by topic. Unsupported for yahoo source.
word_count_greater_than: int | None
News stories will have a word count greater than this value. Unsupported for yahoo source.
word_count_less_than: int | None
News stories will have a word count less than this value. Unsupported for yahoo source.
is_spam: bool | None
Filter whether it is marked as spam or not. Unsupported for yahoo source.
business_relevance_greater_than: float | None
News stories will have a business relevance score more than this value. Unsupported for yahoo source. Value is a decimal between 0 and 1.
business_relevance_less_than: float | None
News stories will have a business relevance score less than this value. Unsupported for yahoo source. Value is a decimal between 0 and 1.
start_date: date | None | str
Start date of the data, in YYYY-MM-DD format. The default is 2 weeks ago.
end_date: date | None | str
End date of the data, in YYYY-MM-DD format. The default is today.
limit: int | None
The number of data entries to return. The number of articles to return.
offset: int | None
Default: 0
Page offset, used in conjunction with limit.
source: str | None
A comma-separated list of the domains requested.
Returns
results: WorldNews
Serializable results.
provider: Optional[Literal['benzinga', 'biztoc', 'fmp', 'intrinio', 'tiingo']]
Provider name.
warnings: Optional[list[Warning_]]
list of warnings.
chart: Optional[Chart]
Chart object.
extra: dict[str, Any]
Extra info.
Data
- standard
- benzinga
- biztoc
- fmp
- intrinio
- tiingo
date: datetime | str
The date of the data. The date of publication.
title: str
Title of the article.
author: str | None
Author of the article.
excerpt: str | None
Excerpt of the article text.
body: str | None
Body of the article text.
images: Any | None
Images associated with the article.
url: str | None
URL to the article.
date: datetime | str
The date of the data. The date of publication.
title: str
Title of the article.
author: str | None
Author of the article.
excerpt: str | None
Excerpt of the article text.
body: str | None
Body of the article text.
images: Any | None
Images associated with the article.
url: str | None
URL to the article.
channels: str | None
Channels associated with the news.
stocks: str | None
Stocks associated with the news.
tags: str | None
Tags associated with the news.
updated: datetime | None
Updated date of the news.
id: str
Article ID.
updated_id: str | None
Updated article ID if the article was updated.
date: datetime | str
The date of the data. The date of publication.
title: str
Title of the article.
author: str | None
Author of the article.
excerpt: str | None
Excerpt of the article text.
body: str | None
Body of the article text.
images: list[dict[str, str]] | None
Images for the article.
url: str | None
URL to the article.
tags: list[str] | None
Tags for the article.
score: float | None
Search relevance score for the article.
date: datetime | str
The date of the data. The date of publication.
title: str
Title of the article.
author: str | None
Author of the article.
excerpt: str | None
Excerpt of the article text.
body: str | None
Body of the article text.
images: Any | None
Images associated with the article.
url: str | None
URL to the article.
source: str
News source.
date: datetime | str
The date of the data. The date of publication.
title: str
Title of the article.
author: str | None
Author of the article.
excerpt: str | None
Excerpt of the article text.
body: str | None
Body of the article text.
images: Any | None
Images associated with the article.
url: str | None
URL to the article.
source: str | None
The source of the news article.
summary: str | None
The summary of the news article.
topics: str | None
The topics related to the news article.
word_count: int | None
The word count of the news article.
business_relevance: float | None
How strongly correlated the news article is to the business
sentiment: str | None
The sentiment of the news article - i.e, negative, positive.
sentiment_confidence: float | None
The confidence score of the sentiment rating.
language: str | None
The language of the news article.
spam: bool | None
Whether the news article is spam.
copyright: str | None
The copyright notice of the news article.
id: str
Article ID.
company: IntrinioCompany | None
The Intrinio Company object. Contains details company reference data.
security: IntrinioSecurity | None
The Intrinio Security object. Contains the security details related to the news article.
date: datetime | str
The date of the data. The date of publication.
title: str
Title of the article.
author: str | None
Author of the article.
excerpt: str | None
Excerpt of the article text.
body: str | None
Body of the article text.
images: Any | None
Images associated with the article.
url: str | None
URL to the article.
symbols: str | None
Ticker tagged in the fetched news.
article_id: int
Unique ID of the news article.
site: str
News source.
tags: str | None
Tags associated with the news article.
crawl_date: datetime
Date the news article was crawled.