Differences

This shows you the differences between two versions of the page.

--- bootcat:help:search_engine_key [2012/07/09 09:28] – [BootCaT and Bing are two very different things] eros
+++ bootcat:help:search_engine_key [2019/10/31 10:53] (current) – [Search Engine Key] eros
@@ Line 1: / Line 1: @@
-===== BootCaT version 0.60 =====
+===== Search Engine Key =====
-** VERSION 0.60 WILL STOP WORKING ON AUGUST 1, 2012, PLEASE UPGRADE TO VERSION 0.61 AS SOON AS POSSIBLE**
+**N.B. We no longer provide support for API keys, below you'll find information about old versions of BootCaT that are no longer maintained.
+**
+===== Bing API version 7 =====
-If you are still using BootCaT version 0.60, please refer to [[bootcat:help:search_engine_key_version_0.60|this page]] for information on your Bing AppId.
+In mid 2017 Bing updated the search engine API to version 7 which is supported since BootCaT version 1.0 (get the latest version of BootCaT [[http://bootcat.dipintra.it/?section=download|here]]).
-See [[bootcat:help:determine_version|this page]] to determine which version of BootCaT you are using
+===== BootCaT 0.81 (and above) =====
-===== BootCaT version 0.61 (July 2, 2012) =====
+==== Why do I need a search engine key? ====
-**YOUR OLD BING APPID (THE KEY USED BY BOOTCAT 0.60) WILL NOT WORK WITH VERSION 0.61 OF BOOTCAT, YOU NEED TO GET A WINDOWS AZURE MARKETPLACE ACCOUNT KEY TO USE THE NEW VERSION OF BOOTCAT.**
-See [[bootcat:help:determine_version|this page]] to determine which version of BootCaT you are using
-==== Why do I need an AppId? ====
 BootCaT uses the [[http://bing.com|Bing]] search engine to find web pages relevant to your domain. Unfortunately, in order to perform this kind of automated search, you need to register for an account that limits the number of queries that can be submitted (this limitation is enforced by Bing to prevent abuses).
-At the time of writing, you can get a **free** account on the Windows Azure Marketplace that lets you submit 5.000 queries a month (every **tuple** you create with BootCaT becomes a **query**, so if you generate 50 tuples, when you click on "Collect URLs" in BootCaT you will use 50 of your queries). If you need more than 5.000 queries a month, you could try signing up for a paid account (see [[#BootCaT and Bing are two very different things|below]]) although this has not been tested yet: if you do decide to buy a paid account, you do it at your own risk.
+At the time of writing, you can get a **free** account on the Microsoft Cognitive Services web site that lets you submit 1.000 free queries a month (every **tuple** you create with BootCaT becomes a **query**, so if you generate 50 tuples, when you click on "Collect URLs" in BootCaT you will use 50 of your queries). If you need more than 1.000 queries a month, you could try signing up for a paid account (see [[#BootCaT and Bing are two very different things|below]]) although this has not been tested yet: if you do decide to buy a paid account, you do it at your own risk.
-==== What's an Account Key and how do I get one? ====
-An Account Key is a sort of password: it's a very long string of letters and numbers. Unlike a password, you don't get to choose what your Account Key is, it's assigned to you and you can't change it.
+==== What's a Key? ====
-To get your free Windows Azure Marketplace Account Key:
+A key is a sort of password: it's a very long string of letters and numbers. Unlike a password, you don't get to choose what your key is, it's assigned to you and you can't change it.
-  * make sure you have a "Windows Live ID" (i.e. a Hotmail e-mail address), if don't have one already, you can sign up (for free) [[https://signup.live.com/|here]]
+==== How do I get a key ====
-  * visit https://datamarket.azure.com/ and click on "Sign in":
-\\
+To get your free Bing Web Search key:
-{{ :marketplace:account_key_01.png?nolink&800 |}}
+  * visit https://www.microsoft.com/cognitive-services/en-us/apis and click on "Get started for free"
-\\
+{{ :bootcat:tutorials:cognitive_services_signup:01.png?nolink |}}
-  * log in using you Windows Live ID:
+  * then click on "Let's go"
-\\
+{{ :bootcat:tutorials:cognitive_services_signup:02.png?nolink |}}
-{{ :marketplace:account_key_02.png?nolink&800 |}}
+  * either login with your existing Microsoft Account or create one for free
-\\
+{{ :bootcat:tutorials:cognitive_services_signup:03.png?nolink |}}
-  * if required, provide additional registration information
+  * click "Yes"
-\\
+{{ :bootcat:tutorials:cognitive_services_signup:04.png?nolink |}}
-{{ :marketplace:account_key_03.png?nolink&800 |}}
+  * scroll down and check "Bing Search Free", then check "I agree to the Microsoft Cognitive Services Terms and Microsoft Privacy Statement" and click on "Subscribe".
-\\
+{{ :bootcat:tutorials:cognitive_services_signup:05.png?nolink |}}
-  * click on "Data"
+That's it, your search engine key is here, you need to click on "Show" to see it: it will be a 32-character-long string of letters and numbers.
-\\
+**YOUR KEY CANNOT BE XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX**
-{{ :marketplace:account_key_04.png?nolink&800 |}}
+{{ :bootcat:tutorials:cognitive_services_signup:06.png?nolink |}}
-\\
+Now you can copy the key and paste it in the relevant field in BootCaT.
-  * the list of all available services will appear, find "Bing Search API" and click on it (**do not** click on "Bing Search API - Web results only"")
+==== BootCaT and Bing are two very different things ====
-\\
+BootCaT is a free software program developed by people at the universities of Bologna, Trento and Zagreb and is in no way affiliated to Bing, a commercial service owned by Microsoft. The main reason for using Bing to retrieve URLs is the fact that it offers a limited number of free queries a month: we don't get a cut if you buy a paid account from Microsoft, nor are we responsible for anything related to Bing.
-{{ :marketplace:account_key_05.png?nolink&800 |}}
+===== BootCaT version 0.71 =====
-\\
+**BootCaT version 0.71 uses the "Windows Azure Marketplace AccountKey" which will STOP WORKING on December 15, 2016.** You'll need to [[http://bootcat.dipintra.it'|upgrade BootCaT]] al least to version 0.81 and get the new Bing Search API key (see above for more info on how to obtain this new key).
-  * in the next page, scroll down until you find the **free** service ($0.00 per month) and click on "Sign up"
+[[bootcat:help:How to get a Windows Azure Marketplace AccountKey]] (outdated info, no longer relevant)
-\\
+===== BootCaT version 0.60 =====
-{{ :marketplace:account_key_06.png?nolink&800 |}}
+** Version 0.60 stopped working August 1, 2012, If you want to use BootCaT you need to upgrade to the latest version**
-\\
+See [[bootcat:help:determine_version|this page]] to determine which version of BootCaT you are using
-  * in the next page, check the box marked by the red arrow and click on "Sign up"
-\\
-{{ :marketplace:account_key_07.png?nolink&800 |}}
-==== Where is my account key? ====
-  * click on "My account"
-\\
-{{ :marketplace:account_key_08.png?nolink&800 |}}
-\\
-  * you Account Key will be on the line "Primary Account Key" marked by the red arrow in the picture below.
-\\
-{{ :marketplace:account_key_09.png?nolink&800 |}}
-\\
-Remember that you don't need to create a new Account Key every time you install BootCaT, you can use the same key on multiple computers.
-NB: it's advisable to use copy/paste to insert the Account Key in the relevant box inside BootCaT, you must use the keyboard shortcut CTRL-V to paste the the key in the box (you need to use CTRL-V, and **not** CMD-V, on Mac too).
-==== BootCaT and Bing are two very different things ====
-BootCaT is a free software program developed by people at the universities of Bologna and Trento and is in no way affiliated to Bing, a commercial service owned by Microsoft. The main reason for using Bing to retrieve URLs is the fact that it offers a limited number of free queries a month: we don't get a cut if you buy a paid account from the Windows Azure Marketplace, nor are we responsible for anything related to Bing.