Yahoo! Search BOSS (Build your Own Search Service) is an initiative in Yahoo! Search to open up Yahoo!'s search
infrastructure and enable third parties to build revolutionary search products leveraging their own data, content, technology, social graph, or other assets. This release includes Web, News, and Image Search as well as Spelling Suggestions.
Table of Contents
1. Getting Started ................................................................................................................. 1
Getting Started ............................................................................................................ 1
Who Should Read This Document .......................................................................... 1
Contact Information ............................................................................................. 1
Terms of Use .............................................................................................................. 1
BOSS Overview .......................................................................................................... 1
Y ahoo! Search BOSS (Build your Own Search Service) is an initiati ve in Yahoo! Search to open up Yahoo!'s
search infrastructure and enable third parties to build revolutionary search products leveraging their own
data, content, technology, social graph, or other assets. This release includes Web, News, and Image Search
as well as Spelling Suggestions.
Getting Started
1.
Go to http://developer.yahoo.com/boss.
2.Sign-up and get your BOSS App ID to get started with the BOSS API.
Note
The BOSS A pp ID is different from the standard W eb services developer App ID. Please
select the BOSS checkbox during signup.
3.Click on the links to find the Developer documentation, FAQ's, Feedback.
Who Should Read This Document
This manual is intended for programmers developing applications to access the Yahoo! Internet search
engine. The manual assumes an understanding of HTTP, XML, JSON, and a cursory knowledge of query
languages.
Contact Information
BOSS developers are encouraged to sign up for the BOSS Yahoo! Group1, a good place to share ideas
with the BOSS developer community.
For account related issues, ideas or suggestions please use the form at http://developer .yahoo.com/re gister/
and select BOSS.
Terms of Use
Use of the Yahoo! Search BOSS services, related software, and this documentation is subject to Terms of
All examples in this documentation require a Boss App ID. Please add the appid= parameter for proper
query execution.
Universal BOSS API Arguments: Apply to Web, Images
and News
Ordinal position of first result. First position is 0. Default sets start to 0.start
Total number of results to return. Maximum value is 50. Default sets count to 10.count
lang
region
format
callback
sites
Specifies the language search product to query. See “Supported Re gions and Languages for Web
and News Search” [16]. Default sets lang to "en". Must be used in parallel with region.
Specifies which regional (country) search product to query. See “Supported Regions and Lan-
guages for Web and News Search” [16]. Default sets region to "us". Must be used in parallel
with lang.
The data format of the response. Value can be set to either "xml" or "json". Default sets
format to "json".
The name of the callback function to wrap the result. Parameter is valid only if format is set to
"json". No default value exists.
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.
Universal BOSS API Query Operators: Apply to Web, Images and News
Note
URL encode any reserved characters in the query and parameters before sending the BOSS
API call. See “Reserved Characters and Escape Values” [15] for more information.
Phrase Words
T o ensure the exact query ke ywords are present in the search result, in the e xact order , use quotation marks
" " around the query keywords.
To exclude content that contains certain keywords, use the - (minus) operator. This operator can be used
in conjunction with other operators in the search query.
Example 1:http://boss.yahooapis.com/ysearch/web/v1/Apple -Pie +Recipes?appid=xyz&format=xml
Example 2: http://boss.yahooapis.com/ysearch/web/v1/"Ice Cream" -Chocolate?appid=bossdemo&format=xml
Site (Domain) search
You can pre-append site: to queries to search for or exclude documents based on the domain of the
document:
Syntax: site:<domain_suffix_value>
The domain name from the URL can be broken into fragments, from right to left. The domain name
www.widget.org could be matched by any of the following queries:
site:www.widget.orgsite:widget.orgsite:org
Getting Started
To select documents from a site or domain we recommend that you use site:
chocolate cake site:widget.org
You can exclude sites (create a negative domain selection) by using the minus operator with site: in
the query. This query (shown unescaped) locates all documents containing the word "food" that do not
have a URL containing the domain "suffix com":
food -site:xyz.com
Example:The following is a query example to find recipe pages at epicurious.com that include salt, pepper ,
ginger, and garlic AND do not include onions: