cheat sheets.

YAHOO BOSS API
==============

URL:
----
http://boss.yahooapis.com/ysearch/{vertical}/v1/{query}?appid=xyz[&param1=val1&pa
am2=val2&etc]

VERTICAL OPTIONS:
-----------------
- web, news, images 

PARAMETERS:
-----------
start     - Ordinal position of first result. First position is 0. Default sets
start to 0.
count     - Total number of results to return. Maximum value is 50. Default sets
count to 10.
lang      - Specifies the language search product to query. See “Supported
Regions and Languages
            for Web and News Search”. Default sets lang to "en". Must be used
            in parallel with region.
region    - Specifies which regional (country) search product to query. See
“Supported Regions
            and Languages for Web and News Search”. Default sets region to
            "us". Must be used in parallel with lang.
format    - The data format of the response. Value can be set to either "xml" or
"json". Default sets format to "json".
callback  - The name of the callback function to wrap the result. Parameter is
valid only if
            format is set to "json". No default value exists.
sites     - Restrict BOSS search results to a set of pre-defined sites. Multiple
sites must be comma separated.
            Example: (sites=abc.com,cnn.com). The Images service does not yet
            support multiple sites.
            Note: This argument can use a single site parameter.
view      - Introducing View! Retrieve additional search data provided by the
respective BOSS service.
            In the current version only view=keyterms is offered via the BOSS
            Web Search service.
            More views for more BOSS services coming soon.
            
       
OPTIONAL PARAMS:
----------------
filter    - Filter out adult or hate content.
type      - Specifies document formats (pdf, msoffice,etc).
view      - view=keyterms will retrieve related words and phrases for each
search result.

PARAM OPTIONS:
--------------
Filter options:
- porn
- hate

Type options:
- msoffice,ppt,html,text, 
- pdf (Adobe Portable Document Format)
- xl (Microsoft Excel: xls, xla, xl)
- msword (Microsoft Word)
- ppt (Microsoft Power Point)

Type Group:
- msoffice: xl, msword, ppt
- nonhtml: text, pdf, xl, msword, ppt

RESPONSE:
---------

== XML

<ysearchresponse responsecode="200">
 
  <nextpage><![CDATA[/ysearch/web/v1/foo?appid={yourBOSSappid}&format=xml&start=1
  ]]></nextpage>
  <resultset_web count="10" start="0" totalhits="29440998" deephits="881000000">
    <result>
      <abstract><![CDATA[World <b>soccer</b> coverage
                from ESPN, including Premiership, Serie A, La Liga, and Major
                League
                <b>Soccer</b>. Get news headlines, live scores, stats, and
                tournament information.]]></abstract>
      <date>2008/06/08</date>
      <dispurl><![CDATA[www.<b>soccernet.com</b>]]></dispurl>
     
      <clickurl>http://us.lrd.yahoo.com/_ylc=X3oDMTFkNXVldGJyBGFwcGlkA2Jvc3NkZW1v
      HBvcwMwBHNlcnZpY2UDWVNlYXJjaARzcmNwdmlkAw--
                /SIG=10u3e8260/**http%3A//www.soccernet.com/</clickurl>
      <size>94650</size>
      <title>ESPN Soccernet</title>
      <url>http://www.soccernet.com/</url>
    </result>
  </resultset_web>
</ysearchresponse>