Yahoo! Finance Web Services - Company News RSS Feed

The Yahoo! Finance Company News RSS feed enables you to get the most recent 25 news items for a company or companies as an RSS feed. You can save those results in My Yahoo! or your favorite feed aggregator, or incorporate that data into your own web site or client application. The Yahoo! Finance company news RSS feed is a dynamically-generated feed based on company stock ticker symbols; only the news items for the ticker symbols you indicate in the request is returned in the feed.

RSS Request

The Yahoo! Finance company news RSS request follows simple HTTP GET syntax: start with a base URL and then add parameters and values after a question mark (?). For the company news RSS feed there is only one parameter: s for the ticker symbol(s) to search for.

http://finance.yahoo.com/rss/headline?s=ticker(s)

You can find out the ticker symbol for a specific company using the Symbol Lookup feature on Yahoo! Finance. For example, to get news items for Yahoo!, use the ticker symbol YHOO and this request URL:

http://finance.yahoo.com/rss/headline?s=yhoo

Ticker symbols are case insensitive. You can separate multiple ticker symbols with a comma:

http://finance.yahoo.com/rss/headline?s=yhoo,msft,tivo

Yahoo! Finance returns an RSS 2.0 feed in response to this request. You can subscribe to the request URL with My Yahoo! or another RSS feed aggregator, or you can incorporate the information in the RSS response into your own application. See RSS Response Elements for information on the elements contained in the RSS feed.

RSS Response Elements

The Yahoo! Finance company news RSS feed is an XML document that conforms to the RSS 2.0 specification. RSS is an XML document containing a single channel element representing the feed, several elements containing metadata about the feed itself, and one or more item elements describing individual items within the feed.  

Top-Level Elements

Element Description
xml The Yahoo! Finance company news RSS feed conforms to XML 1.0. No child elements.
rss The Yahoo! Finance company news RSS feed conforms to RSS 2.0.
Child elements: channel

Channel Elements

The channel element contains metadata about the feed and its contents.

Element Description
title The title of the feed, which includes the ticker symbols in the request. For example "Yahoo! Finance: YHOO News"
link A URL for the Yahoo! Finance News page for the ticker symbols in the request. For example http://finance.yahoo.com/q/h?s=yhoo
language The language of the news items, for example, en-us for US English.
description The overall description of the feed including the company names for the ticker symbols in the request, for example "Latest Financial News for YAHOO INC
copyright The Yahoo! copyright statement for this feed.  
lastBuildDate The last time the feed was updated (the current date and time). The format is in the date format defined by RFC822 Section 5, for example Mon, 256 Sep 17:25:18 -0700.
image The image used to identify this feed. See Image Elements for element descriptions
Child elements: url, title, link, width, height
item A news headline. Each Yahoo! Finance company news feed contains multiple item elements, one for each headline. See Item Elements for element descriptions.
Child elements: title, link, description, guid, pubDate

Image Elements

The image element describes an image or icon used to identify the feed.

Element Description
title The title of the image, for example "Yahoo! Finance"
link The URL of the current search (same as the link element in the parent container)
url The URL of the image
width The width of the image, in pixels
height The height of the image, in pixels

Item Elements

Each item element contains a news item. If the request contained multiple ticker symbols to search, news items for all companies are returned as individual item elements. Note that the feed simply returns the most recent 25 news items for all the ticker symbols in the request; it does not distinguish which item goes with which company.

Element Description
title The news headline, for example "Yahoo! Announces Quarterly Earnings"
link The Yahoo! Finance URL for this news item.
description If given, a short summary of the news item. Many news items include an empty description element.
guid Unique identifier for the item. For news items the guid is the Yahoo! Finance ID for the listing. The attribute isPermaLink is false.
pubDate The date and time this news item was posted, in the date format defined by RFC822 Section 5, Mon, 256 Sep 17:25:18 -0700.

Examples

To get news items for Yahoo!
http://finance.yahoo.com/rss/headline?s=yhoo

To get news items for Yahoo! and Disney:
http://finance.yahoo.com/rss/headline?s=yhoo,dis

A sample RSS response is shown below:

For More Information

For more information on the Yahoo! Finance company news RSS feed, including Terms of Use, see the Yahoo! Finance RSS page.

Acceptable Use

The Yahoo! Finance RSS Feeds are limited to non-commercial use only. See information on our Usage Policy to learn about acceptable uses.