DataMarket and Data Services are being retired and will stop accepting new orders after 12/31/2016. Existing subscriptions will be retired and cancelled starting 3/31/2017. Please reach out to your service provider for options if you want to continue service.

Synonyms API


Published by: Microsoft
Categories: Developer Services, Machine Learning
Date added: 10/31/2012
Get support for this offering

Now available via Customer Technical Preview. Learn more .

The Synonyms API from Bing returns the alternate ways people refer to real world entities like products, people, locations and more. These are known as 'synonyms'. For instance, the API returns the following synonyms for the real world entities shown below:

  • •Product synonyms: "canon rebel t3i" is a synonym of the product Canon 600d
  • •People synonyms: "jlo" is a synonym of the person "Jennifer Lopez"
  • •Location synonyms: "sea tac" is a synonym of the location "Seattle Tacoma International Airport"

These synonyms are mined using several data assets amassed by Bing and has a precision (percentage of correct synonym pairs) of around 90%. Knowledge of synonyms can improve applications like product search, local search or people search. Developers can obtain the synonyms of the necessary entities using the Synonyms API and integrate them into their applications to reap the above benefits.

Read our Developer Guide and FAQ's to get started.

Service root URL

This service supports fixed query. Some queries may include required input parameters. (learn more about query types)


Input parameters:

Name Sample values Type Required
Query canon 600d String Required


Name Type
Synonym String
Last Updated: October 2012


1. WHAT DOES THIS CONTRACT COVER? This is a contract between you and Microsoft Corporation ("Microsoft"). Sometimes Microsoft is referred to as "we," "us" or "our." This contract applies to Bing’s Synonyms API published by Microsoft (hereafter the “API”) provided as a customer technical preview to enable you to evaluate the API and provide feedback as part of a public beta. The API is intended to deliver relevant synonyms (collectively, "Synonyms results") for queries submitted through the API to Microsoft's Bing services (hereafter, "Bing services") for rendering such Synonyms results or otherwise using such Synonyms results within a customer-facing or end-user-facing website ("Website") or application. As used in this contract, "Services" means, collectively and as applicable, the API, the Synonyms results, the Bing services, and any related application IDs, keys or similar. This contract incorporates by reference the Bing terms of use (such Microsoft Services Agreement, found here, and which may be updated from time to time), and any applicable guidelines, documentation or requirements, technical, operational or otherwise relating to the Services, including without limitation the API documentation found here, as they may be published and updated by Microsoft from time to time.

Please note that we do not provide warranties for the Services. This contract also limits our liability. These terms are in Section 11 and Section 12 and we ask you to read them carefully. We provide the Services solely on an "as is" and "as available" basis, in accordance with Section 11, and you acknowledge that latency with regard to delivery of Synonyms results is a function of network bandwidth, server capacity, and other factors. In addition, we reserve the right to vary the Services to individual Websites, users or applications as determined by us in our sole discretion.

2. WHAT RIGHTS DO I HAVE? Solely to the extent that you are in compliance with all terms of this Agreement, we grant you a non-exclusive, non-transferable, non-sublicenseable license to use the Services to: enable your Website or application to obtain Synonyms results solely as necessary to display or use them as a part of your Website or application; or host and display Synonyms results on your Website or application. Your license to use the Services is limited, however, to solely your Websites and applications. You are responsible for your own conduct and content while using the Services and for any consequences of this use.

3. CODE OF CONDUCT / RESTRICTIONS ON USE. Your Website, your application, and your access to and use of any or all of the Services, must comply with all applicable Microsoft policies and guidelines (including, without limitations, any API call volume limitations, security policies, and privacy policies), technical requirements and documentation, and all applicable laws (including, without limitation, the applicable laws of your jurisdiction relating to online conduct, acceptable content, data collection, privacy, and the export of data to the United States or your country of residence). This contract does not grant you any rights related to any services, materials, content, or data other than the Services. You will not, and will not permit your users or other third parties to:

(a) modify, reverse engineer, decompile, or otherwise alter the Services;

(b) distribute, publish, facilitate, enable, or allow access or linking to the Services from any location or source other than your Website or application; Synonyms results

(c) hide or mask from us your identity, or the identity of your service, as it uses the Services, including by failing to follow the identification conventions listed in the API documentation;

(d) defame, abuse, harass, stalk, threaten, or otherwise violate the legal rights (such as rights of privacy and publicity) of others or otherwise violate Microsoft's then-current editorial policies (found here, and which may be updated from time to time);

(e) impersonate another person or entity, or falsify or delete any author attributions, legal or other proper notices or proprietary designations (e.g., copyright or trademark symbols), or labels of the origin or source of services, software, or other materials;

(f) use the Services to violate the law or for any unauthorized purpose;

(g) use the Services to infringe upon the copyright, trademark or other intellectual property rights of anyone;

(h) interfere with or disrupt the Services, or servers or networks related to the Services, or disobey any requirements, procedures, policies, or regulations of networks related to the Services;

(i) create user accounts by automated means or under false or fraudulent pretenses;

(j) promote or provide instructional information about illegal activities or promote physical harm or injury against any group or individual;

(k) copy, store, or cache any Synonyms results;

(l) commercialize (i.e., sell, rent, or lease) Synonyms results;

(m) transmit any virus, worm, defect, Trojan horse, or any other item intended to destroy, surreptitiously interfere with, expropriate, or exert unauthorized control over any system or data or to defraud any person;

(n) create or attempt to create a substitute or similar service or product as that of the Service or Bing through use of or access to any of the Services or proprietary information related to the Services.

4. LIMITATIONS AND CONDITIONS OF THE SERVICE. This API is a pre-release version. It may not work the way a final version of the API will. We may change it for the final, commercial version. We also may not release a commercial version. You may use the API during the Customer Technical Preview for up to 5,000API calls per month. We may use technology or other means to protect the Services, protect our customers, or stop you from breaching this contract. These means may include, for example, filtering to stop spam or increase security. These means may hinder or break your use of the Services, and you may not work around or attempt to thwart or disable any of these technical or other means. We also may, in our sole discretion, limit the: (a) rate at which the Services, or any subset of them, may be called; (b) the amount of storage made available to each Services account; or (c) the length of individual content segments that may be uploaded to, or served from, the Services (all of the foregoing being forms of "Throttling"). We may perform this Throttling globally across all Services, per end user, or on any other basis. You will not take steps to circumvent any technical measures we may put in place to enforce Throttling.

5. END USER TERMS. The Terms of Use located here (which may be updated from time to time, the "Bing TOUs") or such other locations as Microsoft may specify apply to end users' use of and access to Synonyms results through your Website or application. 8. PRIVACY. All access to and use of the Services is subject to the data practices set forth in the Microsoft Online Privacy Statement, which is available here (which may be updated from time to time). Nothing in this contract or the Services provide for the collection or transfer of any personally identifiable information of internet users between the parties. You must maintain a prominent online privacy policy for your Websites and applications that access the Services. This privacy policy, at a minimum, must include: a full, accurate, and clear disclosure regarding the placement, use, and reading of cookies and related technologies, and your collection and use of data in relation to activity by users of your Websites and applications.

6 . HOW WE MAY CHANGE THE CONTRACT. If we modify this contract, then we will provide notice as described in Section 20 below. If you do not agree to any such modifications, then you must stop using the Services. If you do not stop using the Services, then your use of the Services will continue under the modified contract. We may choose in the future to charge for all use of the Services, or change the requirements for use of the Services. If we choose to change the fee requirements for the Services, Microsoft will provide notice of such terms as described in Section 20 below, and you may elect to stop using the Services rather than incurring fees. Any documents or websites incorporated into this contract by reference or link may be modified and updated from time to time by Microsoft and upon such modification or update will be deemed a part of this contract.

7. FEEDBACK. If you give feedback about the API to Microsoft, you give to Microsoft, without charge, the right to use, share and commercialize your feedback in any way and for any purpose. You also give to third parties, without charge, any patent rights needed for their products, technologies and services to use or interface with any specific parts of a Microsoft software or service that includes the feedback. You will not give feedback that is subject to a license that requires Microsoft to license its software or documentation to third parties because we include your feedback in them. These rights survive this agreement.

8. YOUR RESPONSIBILITY. You will indemnify and hold Microsoft (and its directors, officers, affiliates, and agents) parties harmless from and against any and all loss, liability, and expense (including reasonable attorneys' fees and costs) suffered or incurred by reason of any claims, proceedings, or suits based on or arising out of any breach (or alleged breach) by you of this contract, or any part of it, or that otherwise relates to your Website(s), your application(s), or your use of the Services. You will be solely responsible for defending any claim using mutually-agreed counsel, subject to Microsoft's right to participate with counsel it selects, and you will not publicize any claim or agree to any settlement that imposes any obligation or liability on Microsoft (or its directors, officers, affiliates, and agents) without Microsoft's prior written consent, such consent provided by Microsoft in its sole discretion.

9. RESERVATION OF RIGHTS. Microsoft and its suppliers retain all right, title, and interest in and to the Services (including the API and Synonyms results) and all intellectual property rights in any of these. This contract does not grant you any rights in any Microsoft logo, trademark, or service mark, and you will not use any logo, trademark, or service mark of Microsoft for any purpose without Microsoft's prior written approval, other than to attribute Bing in accordance with the Bing Product Guidelines (found here) and API documentation (found here) (as such guidelines and documentation may be updated from time to time), under which you have a limited, non-exclusive, non-transferable, royalty-free license during the term of your use of the Services to use, reproduce, distribute and display the trademarks, service marks, logos and other distinctive brand features of Microsoft specifically contemplated in the Bing Product Guidelines and API documentation (the “Microsoft Brand Features”), so long as your use is strictly in accordance with such guidelines and documentation. You will not claim or imply any sponsorship or endorsement of your Website or application by Microsoft. All uses of Microsoft’s Brand Features and all goodwill associated therewith insure solely to the benefit of Microsoft. Notwithstanding anything else herein to the contrary, Microsoft reserves the right to further limit the license granted in this Section to the extent that your use or display may negatively impact the goodwill or reputation associated with Microsoft’s Brand Features.

10. TERM. This contract will become effective on your first use of the Services. This contract may be terminated immediately for any reason or no reason and without notice by Microsoft. If this contract terminates, all rights granted to you by this contract will automatically terminate and you will cease to have any rights to use the Services (including, without limitation, the API). We will not be liable to you for damages resulting solely from terminating this contract according to its terms. All terms of this contract that, by their nature, are intended to survive termination will survive (including, without limitation, Sections 11 and 12).

11. WE MAKE NO WARRANTY. Microsoft makes no warranties (express, implied, or otherwise), including implied warranties of merchantability, non-infringement, fitness for a particular purpose, or title, related to the Services, its performance, or anything provided in relation to this contract. Without limiting the foregoing, Microsoft makes no guarantees with respect to the availability or uptime of the Services or any other technologies. Microsoft may conduct maintenance on any of the Services at any time, with or without notice.

12. LIABILITY LIMITATION. You can recover from Microsoft and its affiliates and suppliers only direct damages up to US$5. You cannot recover any other damages, including consequential, lost profits, special, indirect, incidental, or punitive damages. This limitation applies to anything related to the Services; content (including code) on third party Internet sites, third party programs or third party conduct; viruses or other disabling features that affect your access to or use of the Services; incompatibility between the Services and other services, software, and hardware; delays or failures you may have in initiating, conducting, or completing any transmissions or transactions in connection with the Services in an accurate or timely manner; and claims for breach of contract, breach of warranty, guarantee, or condition, strict liability, negligence, or other tort. It also applies even if this remedy does not fully compensate you for any losses or fails of its essential purpose or if Microsoft knew or should have known about the possibility of the damages. Some jurisdictions do not allow the exclusion or limitation of incidental or consequential damages, so the above limitations or exclusions may, to a certain or entire extent, not apply to you.

13. CHANGES TO THE SERVICES; CANCELLATION OF THE SERVICES. We may change (including by removing features, adding or removing source types, or charging additional fees for features previously provided free or at different rates), update, or enhance (collectively, "modify," or “modification”) the Services at any time and may require you to obtain and use the most recent versions. Modifications may affect your ability to use the Services and may require you to change (at your sole cost) the way you previously used them. If any modification is unacceptable to you, your only recourse is to stop using the Services. Your continued use of the Services following any posted update or change to the Services will constitute your binding acceptance to the update or change. We will not be liable for any costs that you incur, or for lost profits or damages of any kind, related to any such modification. We may cancel or suspend your use of the Services or our offering of the Services partially or in its entirety at any time. Our cancellation or suspension may be without cause, without notice, or both. Upon cancellation, your right to use the Services (including, without limitation, the API) will cease immediately. Once the Services are cancelled or suspended, any data you have stored on the Services may not be retrieved later.

14. ADDITIONAL INFORMATION. You agree to provide information and/or other materials related to your use of the Services, as reasonably requested by Microsoft to verify your compliance with this contract.

15. INTERPRETING THE CONTRACT. All parts of this contract apply to the maximum extent permitted by law. If any term of this contract is unenforceable, the remainder will be fully enforced to effect the parties' intent. Unless stated or context requires otherwise: (a) all internal references are to this contract and its parties; (b) "days" means "calendar days"; (c) "may" means that the applicable party has a right, but not an accompanying duty; and (d) a party's choices under this contract are in its sole discretion, subject to any applicable duties of good faith. Lists of examples following "including" or "e.g." are not exhaustive (i.e., are interpreted to include "without limitation"), unless qualified by words such as "only" or "solely." This contract will be interpreted according to the plain meaning of its terms without any presumption that it should be construed to favor either party. The section titles in the contract do not limit the other terms of this contract.

16. ASSIGNMENT. We may assign this contract, in whole or in part, at any time with or without notice to you. You may not assign this contract, or any part of it, to any other person without our prior written consent, which will not be unreasonably withheld. Any attempt by you to do so is void. You may not transfer to anyone else, either temporarily or permanently, any rights to use the Services or any part of the Services.

17. NO THIRD PARTY BENEFICIARIES. This contract is solely for your and our benefit. It is not for the benefit of any other person, except for permitted successors and assigns under this contract.

18. CLAIM MUST BE FILED WITHIN ONE YEAR. Any claim related to this contract or the Services may not be brought unless brought within one year. The one-year period begins on the date when the claim first could be filed. If it is not filed, then that claim is permanently barred. This applies to you and your successors. It also applies to us and our successors and assigns.

19. EXPORT. The Services (including the API) are subject to United States export laws and regulations. You must comply with all domestic and international export laws and regulations that apply to the Services. These laws include restrictions on destinations, end users, and end use. Additional information is provided here (as it may be updated from time to time).

20. NOTICES. You may notify Microsoft by postal mail (Microsoft does not accept email notices relating to this contract) addressed as follows: Microsoft Corporation, Attention: LCA - Online Services Division, One Microsoft Way, Redmond, Washington 98052-6399, USA. This contract is in electronic form, and you consent to Microsoft sending you any information related to this contract in electronic form (by email, by access to a Microsoft website designated in an email notice to you, or by posting notice on the Microsoft website located here (or any successor website that Microsoft notifies you of by email)). You may withdraw this consent, but if you do, Microsoft may terminate this contract and your right to access and use the Services. Notices provided to you by email will be deemed given and received on the email transmission date. You acknowledge that, as long as you access or use the Services, you must have, or have access to, the necessary software and hardware to receive these notices.

21. MISCELLANEOUS. The parties are independent contractors under this contract and do not intend to form any other relationship. You understand and acknowledge that Microsoft is not certifying, nor endorsing, and has no obligation to certify or endorse, any aspect of your Website or application. You are solely responsible, and Microsoft specifically disclaims all liability, for your Website or application, any content or other service displayed in or through, accessed via or relating to your Website or application, and any use, display or implementation of the Synonyms results made available to you by Microsoft under this contract. You shall not issue a press release or other written public statement regarding this contract without Microsoft’s written approval. Only written waivers will be effective. Each party will pay its own costs to perform (except where expressly stated otherwise). You will maintain commercially reasonable levels of insurance with commercially reasonable insurers to enable you to comply with your obligations under this contract. In relation to this contract, you will comply with all applicable laws and other requirements of governments having jurisdiction. All rights and remedies under this contract are cumulative. Except as otherwise expressly stated in this contract, this contract is the parties' entire agreement on this subject and merges and supersedes all related prior and contemporaneous communications and agreements. Except as otherwise expressly provided in Sections 6, this contract may only be modified in a writing that is manually signed by both parties after the Effective Date.

22. CHOICE OF LAW AND LOCATION FOR RESOLVING DISPUTES. Washington state law governs the interpretation of this contract and applies to claims for breach of it, regardless of conflict of laws principles. All other claims, including claims regarding consumer protection laws, unfair competition laws, and in tort, will be subject to the laws of your state of residence in the United States, or if you live outside the United States, the laws of the country to which we direct the Services. You and we irrevocably consent to the exclusive jurisdiction and venue of the state or federal courts in King County, Washington, USA for all disputes arising out of or relating to this contract.

A transaction is one request that returns one page of results. Retrieving multiple pages will result in multiple transactions executed.


per month


  • Microsoft PowerPivot For Excel 2010

    Learn how to use Microsoft PowerPivot for Excel 2010, with this and other DataMarket data, to create compelling self-service BI solutions.

  • Tableau Software

    Learn how to visualize this and other DataMarket datasets in Tableau. Tableau’s rapid fire business intelligence solution provides best-in-class data visualization and web dashboards anyone can use.

  • Learn How To Use This Data In Visual Studio

    Learn how to seamlessly consume DataMarket data in Visual Studio with strongly-typed data access and full IntelliSense support to ease development.