BOSS API (Build your Own Search Service) is an API that connects into Yahoo's search infrastructure. It allows developers, start ups, and established consumer internet companies to leverage the power of Yahoo!'s search capabilities.
There are plenty of APIs out there in the search space. Some of them give you an iframe or a widget. The current Search API is designed for rapid development of search applications and mashups. BOSS API is an extension of that rapid development concept and for the first time developers can tap into Yahoo!'s search infrastructure and build applications for commercial use without restrictions around presentation or ordering of results. You can take BOSS API results, blend in your own secret sauce, and build a search engine of your own design.
This first release of BOSS API, developers can fetch search content for Web, News, and Image results.
REST stands for Representational State Transfer. Yahoo! Web Services use "REST-Like" RPC-style operations over HTTP GET or POST requests with parameters encoded into the request URL.
For more information about REST please check out the following:
As a developer using BOSS API, you can choose JSON or XML result outputs.
Developers have expressed interest in altering the result order, removing results they do not want, and blending in their own data. All of these activities are allowed and encouraged with BOSS API.
No. Ads are not compulsory.
Search Ads will be available to qualified developers when BOSS API is launched.
Yahoo! has made the terms of service significantly more flexible than most other APIs, including our previous Search API. Please read the BOSS API terms of service for more information.
This first update to BOSS API in 2011 is our baseline. Significant upgrades are planned and more updates will be provided when we get close to releasing those features. Yahoo! would like your suggestions and feedback for upcoming releases. Please go to the Suggestions Board and click on the BOSS checkbox and send us your suggestions.
Yahoo! is releasing an experimental Python library called the Boss Mashup Framework which provides simplified interfaces for retrieving search results via the Boss API. The framework also provides functions for remixing the results with other data sources.
Support for this product is outlined in the Chapter 1, Getting Started section.
YES. Please join the Yahoo! Search BOSS group at
No. BOSS API uses GET to pass query parameters.
Browser requests are currently not possible since BOSS API uses oAuth. A browser extension may be released in the future.
Yes, you can make simultaneous calls to the BOSS API service. Please note that you will receive 503 gateway timeout errors for the first few simultaneous calls but that should go away after.
A table boss.search was built by Sam Pullara, a BOSS API developer. You will need to provide your consumer key and secret to the table; For example, select * from boss.search where ck=... and secret=... and q="yahoo".