Yahoo! Search BOSS API

BOSS (Build your Own Search Service) is Yahoo!'s open search and data services platform. The goal of BOSS is simple: to foster innovation in the search industry. Developers, start-ups, and large Internet companies can use BOSS to build web-scale search products that utilize Yahoo! Search technology and data. By combining your unique assets and ideas with our search technology assets, you can build innovative experiences that delight your users. BOSS is offered with a low flexible usage fee based on the type of queries. You can also get search advertising in the same service to monetize your offerings.

How Do I Get Started?

  1. Learn more about the BOSS API!
  2. Understand the pricing.
  3. Review the documentation and attribution rules.
  4. Review the step-by-step tutorial to sign up for BOSS.
  5. Create an oAuth key.
  6. Sign up for Yahoo! Search Advertising.
  7. Click here for Support and Community.
  8. Learn more about other BOSS Services.

Overview of BOSS API

The original Yahoo! Search BOSS (Build your Own Search Service) opened up Yahoo!'s search infrastructure to enable third parties to build search products using their own data, content, technology, social graph, or other assets.

This original intent has been enhanced and simplified with this version of BOSS API. Some of the features include re-ranking attributes, brand attribution, enhanced oAuth security, and a simplified API.

  • Unlimited Queries Per Day (See Pricing Chart)
  • No Restrictions on Presentation
  • Re-Ordering Allowed
  • Blending of Proprietary and Yahoo! Search Content Allowed
  • Access to a Limitedweb data set
  • Limited Yahoo! Brand Attribution
  • User Authentication Security
  • Self-Serve with Credit Card Authentication at Sign-up
  • Yahoo! Search Advertising
  • Access to Usage data and Billing
  • Extensive Support and Documentation


Query Type Definition Price/1000 Queries (USD) Max. Results/Query
Full Web Web Search results only. $0.80 50
Limitedweb Web results from a limited index and slower refresh (~ 3 days). $0.40 50
Image Only Image results only. $0.30 35
News Only News results only. $0.10 50
Spelling Only Spelling suggestions. $0.10 1
Blogs Search [Beta] Blog Search Results $0.10 20

This table only reflects an overview of the pricing. Please review the entire pricing and payments.

Support and Community

  1. General questions and comments.
  2. Frequently asked questions.
  3. Account specific questions - Use the account specific Support Form. Instructions on accessing form..

BOSS developers who sign up for new platform have access to a support form for specific questions relating to issues such as billing, services issues, etc.

Additional Information

Why Yahoo! Search BOSS

BOSS offers developers search technology at internet scale and powers hundreds of millions of queries a day. By combining your unique assets and ideas and content assets, BOSS is the platform for the next generation of search innovation, serving hundreds of millions of users across the Web.

Search APIs are nothing new, but typically they've included rate limits, strict terms of service regarding the re-ordering, blending, and presentation of results, and provided little or no opportunity for monetization. These constraints have limited the innovation and commercial viability of new search solutions.

BOSS is different in that it is a set of open API's with as few rules and limitations as possible. Developers and start-ups now have the technology and infrastructure to build enhanced search solutions that can compete head-to-head with the principals in the search industry.

Boss Introduction
View more presentations from Yahoo! Developer Network.

Terms of Use

Use of this service is subject to the BOSS API Terms of Use.

Yahoo! Sponsored Ads for Search

As described here, we are now offering Yahoo! Sponsored Search ads for BOSS. Qualified developers can receive advertising in the same BOSS call as other content. Our partner DDC will work with you to help set your service up. In order to participate, you will need to provide some details about your product, including information about your traffic sources, UI framework, and implementation. Once your product is approved, you will be able to deploy Yahoo! Sponsored Search ads to generate revenue.

Please note that in signing up for the Sponsored Search ad program, you will be entering into a contract with DDC, not Yahoo!, and DDC will handle all ad-related financial payments and support.

Additional Yahoo! Search BOSS Services

The BOSS API is one product among a larger suite of services. Learn more about the various BOSS products.

BOSS Hosted Search - Hosted Search is available for free to publishers. Learn more on the BOSS Hosted Search Page.

BOSS Site Search - Site Search just for your content.

BOSS Shortcuts - User Engagement delivered in-line.

Ready to get started?

By applying for an Application ID for this service, you hereby agree to the Terms of Use

Recent Blog Articles