We’re shutting down this service in April 2011. For further details, please see the Deprecated Services blog post.
The News Search service allows you to search the Internet for news stories.
See information on constructing REST queries
|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:
|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.|
The schema document for this service response is located at http://search.yahooapis.com/NewsSearchService/V1/NewsSearchResponse.xsd
Contains all of the query responses. Has attributes:
|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.|
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.|
The following is a sample response for the query Madonna:
The News Search service is limited to 5,000 queries per IP address per day and to noncommercial use. See information on rate limiting.
Please see our Usage Policy to learn about acceptable uses and how to request additional queries.
The News Search service returns the standard errors. There are no service-specific errors.
The News Search service is discussed on the yws-search-general mailing list.