Yahoo!

Search BOSS
Build Your Own Search Service developer.yahoo.com/boss

search

About BOSS Universal Arguments

BOSS is an open API that enables third-party developers to
use Yahoo! Search to build search products leveraging their ARGUMENT DESCRIPTION DEFAULT
own data, content, technology, social graph, or other assets.
With BOSS, developers can access Yahoo!’s crawling, start Ordinal position of first 0
indexing, ranking, and relevancy algorithms with a powerful result where first position
infrastructure to build and launch Web-scale search products. is 0
count Total number of results 10
to return; Maximum value
URI Syntax is 100
http://boss.yahooapis.com/ysearch/{service}/v1/{query} lang Language search product “en”
?appid={yourBOSSid}[&param1=val1&param2=val2&etc] to query
region Region (country) to query “us”
format Data format of the “json”
BOSS Services response, “xml” or “json”
WEB Search the web callback Name of the callback n/a
function in which to wrap
NEWS Search for news
the result
IMAGES Search for images
sites Restrict BOSS search n/a
SPELLING results to a set of
Retrieve spelling suggestions
SUGGESTIONS pre-defined sites
BOSS SITE
Get traffic and usage of your websites
EXPLORER

Getting Started 1 Read the documentation at

developer.yahoo.com/search/boss 2 Get a BOSS Application ID at
developer.yahoo.com/wsregapp

developer.yahoo.com
 Yahoo! Search BOSS
Build Your Own Search Service

BOSS Service Specifications

SERVICE URL SYNTAX AND EXAMPLE ARGUMENTS RESPONSE FIELDS

WEB SYNTAX http://boss.yahooapis.com/ysearch/web/v1/ filter title start

SEARCH {query}?appid={yourBOSSappid} type url count
[&param1=val1&param2=val2&etc] view totalhits size
abstract deephits date
EX http://boss.yahooapis.com/ysearch/web/v1/ start abstract keyterms
animals?appid=12345&format=xml&start=1 count clickurl searchmonkey_feed
&count=3 lang dispurl searchmonkey_rdf
region
format
callback
sites

IMAGE SYNTAX http://boss.yahooapis.com/ysearch/images/v1/ filter title height

SEARCH {query}?appid={yourBOSSappid} dimensions url date
[&param1=val1&param2=val2&etc] refereurl totalhits mimetype
url deephits refereclickurl
EX http://boss.yahooapis.com/ysearch/images/v1/ start abstract refereurl
fish?appid=12345&format=json&callback=myData count clickurl width
lang filename thumbnail_url
region size thumbnail_height
format format thumbnail_width
callback
sites

NEWS SYNTAX http://boss.yahooapis.com/ysearch/news/v1/ age title height

SEARCH {query}?appid={yourBOSSappid} start url date
[&param1=val1&param2=val2&etc] count totalhits mimetype
lang deephits refereclickurl
EX http://boss.yahooapis.com/ysearch/web/v1/ region abstract refereurl
flood?appid=12345&format=xml&count=5 format clickurl width
&age=1d&orderby=date callback filename thumbnail_url
sites size thumbnail_height
orderby format thumbnail_width

SPELLING SYNTAX http://boss.yahooapis.com/ysearch/spelling/v1/ start totalhits

SUGGESTIONS {query}?appid={yourBOSSappid} count deephits
[&param1=val1&param2=val2&etc] format start
callback count
EX http://boss.yahooapis.com/ysearch/spelling/v1/ sites suggestion
especialy?appid=12345&format=xml

BOSS SITE SYNTAX http://boss.yahooapis.com/ysearch/se_inlink/v1/ entire_site title start

EXPLORER: {siteURL}?appid={yourBOSSappid} omit_inlinks url count
INLINK [&param1=val1&param2=val2&etc] start totalhits
count deephits
EX http://boss.yahooapis.com/ysearch/se_inlink/v1/ format abstract
http%3A%2F%2Fwww.yahoo.com?appid=12345 callback clickurl
&format=xml&omit_inlinks=domain sites

BOSS SITE SYNTAX http://boss.yahooapis.com/ysearch/se_pagedata/v1/ domain_only title start

EXPLORER: {siteURL}?appid={yourBOSSappid} start url count
PAGEDATA [&param1=val1&param2=val2&etc] count totalhits
format deephits
EX http://boss.yahooapis.com/ysearch/se_pagedata/v1/ callback abstract
http%3A%2F%2Fwww.yahoo.com?appid=12345 clickurl
&format=xml&domain_only=1

Resources
YAHOO! SEARCH BOSS GET A BOSS APPLICATION ID YAHOO! SEARCH BLOG
developer.yahoo.com/boss developer.yahoo.com/wsregapp ysearchblog.com

BOSS API GUIDE BOSS DISCUSSION GROUP

developer.yahoo.com/search/boss/boss_guide tech.groups.yahoo.com/group/ysearchboss

developer.yahoo.com