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.
Send Your Suggestions