News Service

News Search collects documents by crawling news related sites. It then parses and normalizes the data, categorizing it, calculating static rank, and placing it into an index, where it is available to search for thirty days from the time it was first crawled.

Note

The sites argument does not work in the news service.

Service URL Syntax

https://yboss.yahooapis.com/ysearch/news?q={keywords}

News Search collects documents by crawling news related sites. It then parses and normalizes the data, categorizing it, calculating static rank, and placing it into an index, where articles are available to search for thirty days from the time they were first crawled.

This chapter explains how to submit news search queries. It describes the following:

  1. Optional arguments

  2. Response fields

    Important

    You must escape reserved characters to use them in argument values, although they are sometimes shown unescaped for readability.

Optional Arguments

These arguments are in addition to the Universal Operators described in BOSS API Overview section. The following arguments are specific to news search.

Argument (Optional) Default value Description
Argument (Optional) | Default value | Description |

Response fields

The fields are defined in the table below:

Example XML Output

Example:

https://yboss.yahooapis.com/ysearch/news?q=obama&format=xml

<bossresponse responsecode="200">
  <news start="0" count="50" totalresults="46230">
    <results>
      <result>
        <abstract>President Barack Obama, turning briefly to his eclipsed domestic agenda, sharpened his sales pitch for clean energy technology Thursday by promising that the payoff would a be wave of jobs — the kind good enough to support families and long-term American prosperity.</abstract>
        <clickurl></clickurl>
        <title>Obama sharpens jobs element of energy pitch</title>
        <language>en english</language>

        <date>1296774145</date>
        <source>AP via Yahoo! News</source>
        <sourceurl>http://news.yahoo.com/</sourceurl>
        <url>http://news.yahoo.com/s/ap/20110203/ap_on_re_us/us_obama_10</url></result>
      <result>