company
Company News. Get news for one or more companies.
Examples
from openbb import obb
obb.news.company(provider='benzinga')
obb.news.company(limit=100, provider='benzinga')
# Get news on the specified dates.
obb.news.company(symbol='AAPL', start_date='2024-02-01', end_date='2024-02-07', provider='intrinio')
# Display the headlines of the news.
obb.news.company(symbol='AAPL', display=headline, provider='benzinga')
# Get news for multiple symbols.
obb.news.company(symbol='aapl,tsla', provider='fmp')
# Get news company's ISIN.
obb.news.company(symbol='NVDA', isin=US0378331005, provider='benzinga')
Parameters
- standard
- benzinga
- fmp
- intrinio
- polygon
- tiingo
- tmx
- yfinance
symbol: Union[str, list[str]]
Symbol to get data for. Multiple items allowed for provider(s): benzinga, fmp, intrinio, polygon, tiingo, tmx, yfinance.
• Optional: True
start_date: Union[date, str]
Start date of the data, in YYYY-MM-DD format.
• Optional: True
end_date: Union[date, str]
End date of the data, in YYYY-MM-DD format.
• Optional: True
limit: Annotated[int, Ge(ge=0)]
The number of data entries to return.
• Default: 2500
• Optional: True
symbol: Union[str, list[str]]
Symbol to get data for. Multiple items allowed for provider(s): benzinga, fmp, intrinio, polygon, tiingo, tmx, yfinance.
• Optional: True
start_date: Union[date, str]
Start date of the data, in YYYY-MM-DD format.
• Optional: True
end_date: Union[date, str]
End date of the data, in YYYY-MM-DD format.
• Optional: True
limit: Annotated[int, Ge(ge=0)]
The number of data entries to return.
• Default: 2500
• Optional: True
date: Union[date, str]
A specific date to get data for.
• Optional: True
display: Literal['headline', 'abstract', 'full']
Specify headline only (headline), headline + teaser (abstract), or headline + full body (full).
• Default: full
• Optional: True
updated_since: int
Number of seconds since the news was updated.
• Optional: True
published_since: int
Number of seconds since the news was published.
• Optional: True
sort: Literal['id', 'created', 'updated']
Key to sort the news by.
• Default: created
• Optional: True
order: Literal['asc', 'desc']
Order to sort the news by.
• Default: desc
• Optional: True
isin: str
The company's ISIN.
• Optional: True
cusip: str
The company's CUSIP.
• Optional: True
channels: str
Channels of the news to retrieve.
• Optional: True
topics: str
Topics of the news to retrieve.
• Optional: True
authors: str
Authors of the news to retrieve.
• Optional: True
content_types: str
Content types of the news to retrieve.
• Optional: True
symbol: Union[str, list[str]]
Symbol to get data for. Multiple items allowed for provider(s): benzinga, fmp, intrinio, polygon, tiingo, tmx, yfinance.
• Optional: True
start_date: Union[date, str]
Start date of the data, in YYYY-MM-DD format.
• Optional: True
end_date: Union[date, str]
End date of the data, in YYYY-MM-DD format.
• Optional: True
limit: Annotated[int, Ge(ge=0)]
The number of data entries to return.
• Default: 2500
• Optional: True
page: int
Page number of the results. Use in combination with limit.
• Default: 0
• Optional: True
symbol: Union[str, list[str]]
Symbol to get data for. Multiple items allowed for provider(s): benzinga, fmp, intrinio, polygon, tiingo, tmx, yfinance.
• Optional: True
start_date: Union[date, str]
Start date of the data, in YYYY-MM-DD format.
• Optional: True
end_date: Union[date, str]
End date of the data, in YYYY-MM-DD format.
• Optional: True
limit: Annotated[int, Ge(ge=0)]
The number of data entries to return.
• Default: 2500
• Optional: True
source: Literal['yahoo', 'moody', 'moody_us_news', 'moody_us_press_releases']
The source of the news article.
• Optional: True
sentiment: Literal['positive', 'neutral', 'negative']
Return news only from this source.
• Optional: True
language: str
Filter by language. Unsupported for yahoo source.
• Optional: True
topic: str
Filter by topic. Unsupported for yahoo source.
• Optional: True
word_count_greater_than: int
News stories will have a word count greater than this value. Unsupported for yahoo source.
• Optional: True
word_count_less_than: int
News stories will have a word count less than this value. Unsupported for yahoo source.
• Optional: True
is_spam: bool
Filter whether it is marked as spam or not. Unsupported for yahoo source.
• Optional: True
business_relevance_greater_than: float
News stories will have a business relevance score more than this value. Unsupported for yahoo source. Value is a decimal between 0 and 1.
• Optional: True
business_relevance_less_than: float
News stories will have a business relevance score less than this value. Unsupported for yahoo source. Value is a decimal between 0 and 1.
• Optional: True
symbol: Union[str, list[str]]
Symbol to get data for. Multiple items allowed for provider(s): benzinga, fmp, intrinio, polygon, tiingo, tmx, yfinance.
• Optional: True
start_date: Union[date, str]
Start date of the data, in YYYY-MM-DD format.
• Optional: True
end_date: Union[date, str]
End date of the data, in YYYY-MM-DD format.
• Optional: True
limit: Annotated[int, Ge(ge=0)]
The number of data entries to return.
• Default: 2500
• Optional: True
order: Literal['asc', 'desc']
Sort order of the articles.
• Default: desc
• Optional: True
symbol: Union[str, list[str]]
Symbol to get data for. Multiple items allowed for provider(s): benzinga, fmp, intrinio, polygon, tiingo, tmx, yfinance.
• Optional: True
start_date: Union[date, str]
Start date of the data, in YYYY-MM-DD format.
• Optional: True
end_date: Union[date, str]
End date of the data, in YYYY-MM-DD format.
• Optional: True
limit: Annotated[int, Ge(ge=0)]
The number of data entries to return.
• Default: 2500
• Optional: True
offset: int
Page offset, used in conjunction with limit.
• Default: 0
• Optional: True
source: Union[str, list[str]]
A comma-separated list of the domains requested. Multiple items allowed for provider(s): tiingo.
• Optional: True
symbol: Union[str, list[str]]
Symbol to get data for. Multiple items allowed for provider(s): benzinga, fmp, intrinio, polygon, tiingo, tmx, yfinance.
• Optional: True
start_date: Union[date, str]
Start date of the data, in YYYY-MM-DD format.
• Optional: True
end_date: Union[date, str]
End date of the data, in YYYY-MM-DD format.
• Optional: True
limit: Annotated[int, Ge(ge=0)]
The number of data entries to return.
• Default: 2500
• Optional: True
page: int
The page number to start from. Use with limit.
• Default: 1
• Optional: True
symbol: Union[str, list[str]]
Symbol to get data for. Multiple items allowed for provider(s): benzinga, fmp, intrinio, polygon, tiingo, tmx, yfinance.
• Optional: True
start_date: Union[date, str]
Start date of the data, in YYYY-MM-DD format.
• Optional: True
end_date: Union[date, str]
End date of the data, in YYYY-MM-DD format.
• Optional: True
limit: Annotated[int, Ge(ge=0)]
The number of data entries to return.
• Default: 2500
• Optional: True
Returns
results: list[CompanyNews]
Serializable results.
provider: Optional[Literal['benzinga', 'fmp', 'intrinio', 'polygon', 'tiingo', 'tmx', 'yfinance']]
Provider name.
warnings: Optional[list[Warning_]]
list of warnings.
chart: Optional[Chart]
Chart object.
extra: dict[str, Any]
Extra info.
Data
- standard
- benzinga
- fmp
- intrinio
- polygon
- tiingo
- tmx
- yfinance
date: Union[datetime, str]
The date of the data. Here it is the published date of the article.
title: str
Title of the article.
text: str
Text/body of the article.
images: list[Dict[str, str]]
Images associated with the article.
url: str
URL to the article.
symbols: str
Symbols associated with the article.
date: Union[datetime, str]
The date of the data. Here it is the published date of the article.
title: str
Title of the article.
text: str
Text/body of the article.
images: list[Dict[str, str]]
URL to the images of the news.
url: str
URL to the article.
symbols: str
Symbols associated with the article.
id: str
Article ID.
author: str
Author of the article.
teaser: str
Teaser of the news.
channels: str
Channels associated with the news.
stocks: str
Stocks associated with the news.
tags: str
Tags associated with the news.
updated: datetime
Updated date of the news.
date: Union[datetime, str]
The date of the data. Here it is the published date of the article.
title: str
Title of the article.
text: str
Text/body of the article.
images: list[Dict[str, str]]
Images associated with the article.
url: str
URL to the article.
symbols: str
Symbols associated with the article.
source: str
Name of the news source.
date: Union[datetime, str]
The date of the data. Here it is the published date of the article.
title: str
Title of the article.
text: str
Text/body of the article.
images: list[Dict[str, str]]
Images associated with the article.
url: str
URL to the article.
symbols: str
Symbols associated with the article.
source: str
The source of the news article.
summary: str
The summary of the news article.
topics: str
The topics related to the news article.
word_count: int
The word count of the news article.
business_relevance: float
How strongly correlated the news article is to the business
sentiment: str
The sentiment of the news article - i.e, negative, positive.
sentiment_confidence: float
The confidence score of the sentiment rating.
language: str
The language of the news article.
spam: bool
Whether the news article is spam.
copyright: str
The copyright notice of the news article.
id: str
Article ID.
security: IntrinioSecurity
The Intrinio Security object. Contains the security details related to the news article.
date: Union[datetime, str]
The date of the data. Here it is the published date of the article.
title: str
Title of the article.
text: str
Text/body of the article.
images: list[Dict[str, str]]
Images associated with the article.
url: str
URL to the article.
symbols: str
Symbols associated with the article.
source: str
Source of the article.
tags: str
Keywords/tags in the article
id: str
Article ID.
amp_url: str
AMP URL.
publisher: PolygonPublisher
Publisher of the article.
date: Union[datetime, str]
The date of the data. Here it is the published date of the article.
title: str
Title of the article.
text: str
Text/body of the article.
images: list[Dict[str, str]]
Images associated with the article.
url: str
URL to the article.
symbols: str
Symbols associated with the article.
tags: str
Tags associated with the news article.
article_id: int
Unique ID of the news article.
source: str
News source.
crawl_date: datetime
Date the news article was crawled.
date: Union[datetime, str]
The date of the data. Here it is the published date of the article.
title: str
Title of the article.
text: str
Text/body of the article.
images: list[Dict[str, str]]
Images associated with the article.
url: str
URL to the article.
symbols: str
Symbols associated with the article.
source: str
Source of the news.
date: Union[datetime, str]
The date of the data. Here it is the published date of the article.
title: str
Title of the article.
text: str
Text/body of the article.
images: list[Dict[str, str]]
Images associated with the article.
url: str
URL to the article.
symbols: str
Symbols associated with the article.
source: str
Source of the news article