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

Name	Type	Description	Default	Optional
symbol	Union[str, List[str]]	Symbol to get data for. Multiple items allowed for provider(s): benzinga, fmp, intrinio, polygon, tiingo, tmx, yfinance.	None	True
start_date	Union[date, str]	Start date of the data, in YYYY-MM-DD format.	None	True
end_date	Union[date, str]	End date of the data, in YYYY-MM-DD format.	None	True
limit	Annotated[int, Ge(ge=0)]	The number of data entries to return.	2500	True

Name	Type	Description	Default	Optional
symbol	Union[str, List[str]]	Symbol to get data for. Multiple items allowed for provider(s): benzinga, fmp, intrinio, polygon, tiingo, tmx, yfinance.	None	True
start_date	Union[date, str]	Start date of the data, in YYYY-MM-DD format.	None	True
end_date	Union[date, str]	End date of the data, in YYYY-MM-DD format.	None	True
limit	Annotated[int, Ge(ge=0)]	The number of data entries to return.	2500	True
date	Union[date, str]	A specific date to get data for.	None	True
display	Literal['headline', 'abstract', 'full']	Specify headline only (headline), headline + teaser (abstract), or headline + full body (full).	full	True
updated_since	int	Number of seconds since the news was updated.	None	True
published_since	int	Number of seconds since the news was published.	None	True
sort	Literal['id', 'created', 'updated']	Key to sort the news by.	created	True
order	Literal['asc', 'desc']	Order to sort the news by.	desc	True
isin	str	The company's ISIN.	None	True
cusip	str	The company's CUSIP.	None	True
channels	str	Channels of the news to retrieve.	None	True
topics	str	Topics of the news to retrieve.	None	True
authors	str	Authors of the news to retrieve.	None	True
content_types	str	Content types of the news to retrieve.	None	True

Name	Type	Description	Default	Optional
symbol	Union[str, List[str]]	Symbol to get data for. Multiple items allowed for provider(s): benzinga, fmp, intrinio, polygon, tiingo, tmx, yfinance.	None	True
start_date	Union[date, str]	Start date of the data, in YYYY-MM-DD format.	None	True
end_date	Union[date, str]	End date of the data, in YYYY-MM-DD format.	None	True
limit	Annotated[int, Ge(ge=0)]	The number of data entries to return.	2500	True
page	int	Page number of the results. Use in combination with limit.	0	True

Name	Type	Description	Default	Optional
symbol	Union[str, List[str]]	Symbol to get data for. Multiple items allowed for provider(s): benzinga, fmp, intrinio, polygon, tiingo, tmx, yfinance.	None	True
start_date	Union[date, str]	Start date of the data, in YYYY-MM-DD format.	None	True
end_date	Union[date, str]	End date of the data, in YYYY-MM-DD format.	None	True
limit	Annotated[int, Ge(ge=0)]	The number of data entries to return.	2500	True
source	Literal['yahoo', 'moody', 'moody_us_news', 'moody_us_press_releases']	The source of the news article.	None	True
sentiment	Literal['positive', 'neutral', 'negative']	Return news only from this source.	None	True
language	str	Filter by language. Unsupported for yahoo source.	None	True
topic	str	Filter by topic. Unsupported for yahoo source.	None	True
word_count_greater_than	int	News stories will have a word count greater than this value. Unsupported for yahoo source.	None	True
word_count_less_than	int	News stories will have a word count less than this value. Unsupported for yahoo source.	None	True
is_spam	bool	Filter whether it is marked as spam or not. Unsupported for yahoo source.	None	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.	None	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.	None	True

Name	Type	Description	Default	Optional
symbol	Union[str, List[str]]	Symbol to get data for. Multiple items allowed for provider(s): benzinga, fmp, intrinio, polygon, tiingo, tmx, yfinance.	None	True
start_date	Union[date, str]	Start date of the data, in YYYY-MM-DD format.	None	True
end_date	Union[date, str]	End date of the data, in YYYY-MM-DD format.	None	True
limit	Annotated[int, Ge(ge=0)]	The number of data entries to return.	2500	True
order	Literal['asc', 'desc']	Sort order of the articles.	desc	True

Name	Type	Description	Default	Optional
symbol	Union[str, List[str]]	Symbol to get data for. Multiple items allowed for provider(s): benzinga, fmp, intrinio, polygon, tiingo, tmx, yfinance.	None	True
start_date	Union[date, str]	Start date of the data, in YYYY-MM-DD format.	None	True
end_date	Union[date, str]	End date of the data, in YYYY-MM-DD format.	None	True
limit	Annotated[int, Ge(ge=0)]	The number of data entries to return.	2500	True
offset	int	Page offset, used in conjunction with limit.	0	True
source	Union[str, List[str]]	A comma-separated list of the domains requested. Multiple items allowed for provider(s): tiingo.	None	True

Name	Type	Description	Default	Optional
symbol	Union[str, List[str]]	Symbol to get data for. Multiple items allowed for provider(s): benzinga, fmp, intrinio, polygon, tiingo, tmx, yfinance.	None	True
start_date	Union[date, str]	Start date of the data, in YYYY-MM-DD format.	None	True
end_date	Union[date, str]	End date of the data, in YYYY-MM-DD format.	None	True
limit	Annotated[int, Ge(ge=0)]	The number of data entries to return.	2500	True
page	int	The page number to start from. Use with limit.	1	True

Name	Type	Description	Default	Optional
symbol	Union[str, List[str]]	Symbol to get data for. Multiple items allowed for provider(s): benzinga, fmp, intrinio, polygon, tiingo, tmx, yfinance.	None	True
start_date	Union[date, str]	Start date of the data, in YYYY-MM-DD format.	None	True
end_date	Union[date, str]	End date of the data, in YYYY-MM-DD format.	None	True
limit	Annotated[int, Ge(ge=0)]	The number of data entries to return.	2500	True

---

Returns

OBBject
    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

Name	Type	Description
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.

Name	Type	Description
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.

Name	Type	Description
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.

Name	Type	Description
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.

Name	Type	Description
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.

Name	Type	Description
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.

Name	Type	Description
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.

Name	Type	Description
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