Multiple Services and Keywords

The following specification details the GET or input function of the Yahoo BOSS API using a multi-service with keywords GET function and a multi-service and multi-keyword GET function that specifies the keywords per service to be searched.

Service URL Syntax #1

https://yboss.yahooapis.com/ysearch/{service,*}?q={keyword}

Simple Query Example

https://yboss.yahooapis.com/ysearch/limitedweb,image?q=yahoo&format=xml&count=2

Example XML Output #1

<bossresponse responsecode="200">
  <images start="0" count="2" totalresults="55200000">
    <results>
      <result>
        <clickurl>http://www.cyber-cinema.com/reprint/CarsAdvC867027.jpg</clickurl>
        <size>83.1KB</size>
        <format>jpeg</format>

        <height>730</height>
        <refererclickurl>http://www.cyber-cinema.com/abc/cars.html</refererclickurl>
        <refererurl>http://www.cyber-cinema.com/abc/cars.html</refererurl>
        <title>Cars Movie Posters at Cyber Cinema</title>
        <url>http://www.cyber-cinema.com/reprint/CarsAdvC867027.jpg</url>
        <width>500</width>

        <thumbnailheight>160</thumbnailheight>
        <thumbnailurl>http://ts4.mm.bing.net/images/thumbnail.aspx?q=517477577051&amp;amp;id=059d55fd55dd45681eb4e883a7ed0707</thumbnailurl>
        <thumbnailwidth>109</thumbnailwidth></result>
      <result>
        <clickurl>http://www.moviewallpaper.net/wpp/Cars_Wallpaper_2_800.jpg</clickurl>
        <size>317.7KB</size>

        <format>jpeg</format>
        <height>768</height>
        <refererclickurl>http://www.moviewallpaper.net/w/Cars_Wallpaper_2_800.html</refererclickurl>
        <refererurl>http://www.moviewallpaper.net/w/Cars_Wallpaper_2_800.html</refererurl>
        <title>Wallpaper Download Page - Cars Wallpaper 2</title>
        <url>http://www.moviewallpaper.net/wpp/Cars_Wallpaper_2_800.jpg</url>

        <width>1024</width>
        <thumbnailheight>120</thumbnailheight>
        <thumbnailurl>http://ts1.mm.bing.net/images/thumbnail.aspx?q=678144836976&amp;amp;id=ebc38086c87b3e9e7fd565cbfd29ca0a</thumbnailurl>
        <thumbnailwidth>160</thumbnailwidth></result></results></images>
  <limitedweb start="0" count="2" totalresults="100000000">
    <results>

      <result>
        <date>2011/03/30</date>
        <clickurl>http://www.cars.com/</clickurl>
        <url>http://www.cars.com/</url>
        <dispurl type="default">www.cars.com</dispurl>
        <title type="default">New &amp;amp; Used Cars for Sale, Auto Dealers, Car Reviews and Car ...</title>

        <abstract type="default">Search 2.6 million new &amp;amp; used car listings, price a new car, get a dealer quote, read expert reviews, or sell your car
         at thousands over trade-in.</abstract>
      </result>
      <result>
        <date>2011/03/30</date>
        <clickurl>http://www.autotrader.com/</clickurl>
        <url>http://www.autotrader.com/</url>
        <dispurl type="default">www.autotrader.com</dispurl>

        <title type="default">New Cars, Used Cars - Find Cars at AutoTrader.com</title>
        <abstract type="default">Find used cars and new cars for sale at AutoTrader.com. With millions of cars, finding your next new car or used car and the
         car reviews and information you're ...</abstract>
      </result>
    </results>
  </limitedweb>
</bossresponse>

Service URL Syntax #2

https://yboss.yahooapis.com/ysearch/{service,*}?service1.q={keywords}&service2.q={keywords}

Simple Query Example

https://yboss.yahooapis.com/ysearch/news,limitedweb?news.q=yahoo&limitedweb.q=microsoft+yahoo&format=xml&count=2

Example XML Output #2

<bossresponse responsecode="200">
  <news start="0" count="2" totalresults="5773">
    <results>
      <result>
        <abstract>Yahoo Inc. Chief Executive Carol Bartz, hired more than two years ago to revamp the Internet giant,
         has seen her popularity among employees fall sharply during the past year, according to a report to be published Friday.</abstract><clickurl></clickurl>
        <title>Yahoo CEO Bartz’s popularity dips: report</title>
        <language>en english</language>

        <date>1301621557</date>
        <source>Market Watch</source>
        <sourceurl>http://www.marketwatch.com/</sourceurl>
        <url>http://www.marketwatch.com/news/story.asp?guid=%7BBDA4C44E-5BD9-11E0-9F0E-00212804637C%7D&amp;siteid=rss&amp;rss=1</url></result>

  <limitedweb start="0" count="2" totalresults="17600000">
    <results>
      <result>
        <date>2011/03/31</date>
        <clickurl>http://www.searchalliance.com/home</clickurl>
        <url>http://www.searchalliance.com/home</url>
        <dispurl type="default">searchalliance.com</dispurl>

        <title type="default">Yahoo &amp;amp; Microsoft Search Alliance – Official News on the Deal</title>
        <abstract type="default">Advertising on Yahoo Search and Bing is now even easier. Advertisers can now use one account
         to reach 30.6% of the U.S. search market (165 million unique searchers ...</abstract></result>
      <result><date></date>
        <clickurl>http://topics.nytimes.com/top/news/business/companies/yahoo_inc/yahoo-microsoft-deal/index.html</clickurl>
        <url>http://topics.nytimes.com/top/news/business/companies/yahoo_inc/yahoo-microsoft-deal/index.html</url>
        <dispurl type="default">topics.nytimes.com/top/news/business/companies/yahoo_inc/yahoo-microsoft-deal/index.html</dispurl>

        <title type="default">Microsoft-Yahoo Deal News - The New York Times</title>
        <abstract type="default">News about the Yahoo-Microsoft deal. Commentary and archival information about the Microsoft-Yahoo Deal from
         The New York Times.</abstract>
      </result>
    </results>
  </limitedweb>
</bossresponse>