News Search Documentation for Yahoo! Search

We’re shutting down this service in April 2011. For further details, please see the Deprecated Services blog post.

Submitting News Queries

The News Search service allows you to search the Internet for news stories.

Request URL

http://search.yahooapis.com/NewsSearchService/V1/newsSearch

Request parameters

See information on constructing REST queries

Parameter	Value	Description
appid	string (required)	The application ID. See Application IDs for more information.
query	string (required)	The query to search for.
type	all (default), any, or phrase	The kind of search to submit: all returns results with all query terms. any returns results with one or more of the query terms. phrase returns results containing the query terms as a phrase.
results	integer: default 10, max 50	The number of results to return.
start	integer: default 1	The starting result position to return (1-based). The finishing position (start + results - 1) cannot exceed 1000.
sort	rank (default) or date	Sort articles by relevance or most-recent.
language	string	The language the results are written in. Supported Languages. Omitting language returns results in any language.
site	string: default no value	A domain to restrict your searches to (e.g. www.yahoo.com). You may submit up to 30 values (site=www.yahoo.com&site=www.cnn.com).
output	string: xml (default), json, php	The format for the output. If json is requested, the results will be returned in JSON format. If php is requested, the results will be returned in Serialized PHP format.
callback	string	The name of the callback function to wrap around the JSON data. The following characters are allowed: A-Z a-z 0-9 . [] and _. If output=json has not been requested, this parameter has no effect. More information on the callback can be found in the Yahoo! Developer Network JSON Documentation.

Sample Request Url: http://search.yahooapis.com/NewsSearchService/V1/newsSearch?appid=YahooDemo&query=madonna&results=2&language=en

Response fields

The schema document for this service response is located at http://search.yahooapis.com/NewsSearchService/V1/NewsSearchResponse.xsd

Field	Description
ResultSet	Contains all of the query responses. Has attributes: totalResultsAvailable: The number of query matches in the database. totalResultsReturned: The number of query matches returned. This may be lower than the number of results requested if there were fewer total results available. firstResultPosition: The position of the first result in the overall search.
Result	Contains each individual response.
Title	The title of the article.
Summary	Summary text associated with the article.
Url	The URL for the article.
ClickUrl	The URL for linking to the article. See URL linking for more information.
NewsSource	The company that distributed the news article, such as API or BBC.
NewsSourceUrl	The URL for the news source.
Language	The language the article is written in.
PublishDate	The date the article was first published, in unix timestamp format.
ModificationDate	The date the article was last modified, in unix timestamp format.
Thumbnail	The URL of a thumbnail file associated with the article, if present, and its height and width in pixels.

Sample response

The following is a sample response for the query Madonna:

<ResultSet xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="urn:yahoo:yn" xsi:schemaLocation="urn:yahoo:yn http://search.yahooapis.com/NewsSearchService/V1/NewsSearchResponse.xsd" totalResultsAvailable="890" totalResultsReturned="2" firstResultPosition="1"> <Result> <Title>Madonna's Holiday Rip-Off</Title> <Summary>Madonna has a bee in her bonnet and the 'B' stands for Blige. Anyone who thought Mary J. Blige's Barbershop 2 song 'Not Today' sounds an awful lot like Madonna's 'Holiday' is not alone.</Summary> <Url>http://www.muchmusic.com/news/story.asp?id=15432</Url> <ClickUrl>http://www.muchmusic.com/news/story.asp?id=15432</ClickUrl> <NewsSource>MuchMusic.com</NewsSource> <NewsSourceUrl>http://www.muchmusic.com/news/</NewsSourceUrl> <Language>en</Language> <PublishDate>1106069393</PublishDate> <ModificationDate></ModificationDate> </Result> <Result> <Title>National : BBC Uncovers Madonna's Kabbalah Center</Title> <Summary>The British Broadcasting Corporation has aired a documentary that has put Madonna and other Hollywood celebs who embrace a newly packaged version of Kabbalah in some hot water.</Summary> <Url>http://www.theconservativevoice.com/modules/news/article.php?storyid=2079</Url> <ClickUrl>http://www.theconservativevoice.com/modules/news/article.php?storyid=2079</ClickUrl> <NewsSource>The Conservative Voice</NewsSource> <NewsSourceUrl>http://www.theconservativevoice.com/</NewsSourceUrl> <Language>en</Language> <PublishDate>1106082108</PublishDate> <ModificationDate></ModificationDate> </Result> </ResultSet>

Rate Limits

The News Search service is limited to 5,000 queries per IP address per day and to noncommercial use. See information on rate limiting.

Terms of Use

Please see our Usage Policy to learn about acceptable uses and how to request additional queries.

Errors

The News Search service returns the standard errors. There are no service-specific errors.

Support & Community

The News Search service is discussed on the yws-search-general mailing list.