bootcat:help:search_engine_key

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision		 Previous revision
Next revisionBoth sides next revision
bootcat:help:search_engine_key [2014/11/19 15:06] – [Where is my account key?] erosbootcat:help:search_engine_key [2017/11/29 10:39] – eros
Line 1: Line 1:
-===== Windows Azure Marketplace Account Key =====+===== Search Engine Key version =====
  
-==== Why do I need an 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]]).
  
-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).+===== BootCaT 0.81 (and above) =====
  
-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. +==== Why do I need a search engine key? ====
-==== 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.+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).
  
-To get your free Windows Azure Marketplace Account Key:+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.
  
-  * 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]] +==== What's a Key? ====
-  * visit https://datamarket.azure.com/ and click on "Sign in":+
  
-\\+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.
  
-{{ :marketplace:account_key_01.png?nolink&800 |}}+==== How do I get a key ====
  
-\\+To get your free Bing Web Search key:
  
-  * log in using you Windows Live ID:+  * 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 |}}
  
-{{ :marketplace:account_key_02.png?nolink&800 |}}+  * then click on "Let's go"
  
-\\+{{ :bootcat:tutorials:cognitive_services_signup:02.png?nolink |}}
  
-  * if required, provide additional registration information+  * either login with your existing Microsoft Account or create one for free
  
-\\+{{ :bootcat:tutorials:cognitive_services_signup:03.png?nolink |}}
  
-{{ :marketplace:account_key_03.png?nolink&800 |}}+  * click "Yes"
  
-\\+{{ :bootcat:tutorials:cognitive_services_signup:04.png?nolink |}}
  
-  * click on "Data"+  * 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 |}}
  
-{{ :marketplace:account_key_04.png?nolink&800 |}}+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**
  
-  * 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:tutorials:cognitive_services_signup:06.png?nolink |}}
  
-\\+Now you can copy the key and paste it in the relevant field in BootCaT.
  
-{{ :marketplace:account_key_05.png?nolink&800 |}}+==== 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.
  
-  * in the next page, scroll down until you find the **free** service ($0.00 per month) and click on "Sign up"+===== 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).
- +
-{{ :marketplace:account_key_06.png?nolink&800 |}} +
- +
-\\ +
- +
-  * 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? ==== +
- +
-  * Sign in here: http://www.bing.com/toolbox/bingsearchapi +
- +
-  * 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 |}} +
- +
-\\ +
-==== You're done! ==== +
- +
-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. +
- +
-==== 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 the Windows Azure Marketplace, nor are we responsible for anything related to Bing.+[[bootcat:help:How to get a Windows Azure Marketplace AccountKey]] (outdated info, no longer relevant)
  
 ===== BootCaT version 0.60 ===== ===== BootCaT version 0.60 =====
  
-** VERSION 0.60 STOPPED WORKING ON AUGUST 1, 2012, IF YOU WANT TO USE BOOTCAT YOU NEED TO UPGRADE TO THE LATEST VERSION**+** 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 See [[bootcat:help:determine_version|this page]] to determine which version of BootCaT you are using
  • bootcat/help/search_engine_key.txt
  • Last modified: 2019/10/31 10:53
  • by eros