{"id":136,"date":"2019-10-25T14:25:30","date_gmt":"2019-10-25T13:25:30","guid":{"rendered":"https:\/\/blogs.ncl.ac.uk\/nubsteachinglearningtechnologyforum\/?p=136"},"modified":"2019-10-30T09:24:39","modified_gmt":"2019-10-30T09:24:39","slug":"how-to-financial-times-headline-api","status":"publish","type":"post","link":"https:\/\/blogs.ncl.ac.uk\/nubsteachinglearningtechnologyforum\/2019\/10\/25\/how-to-financial-times-headline-api\/","title":{"rendered":"How-to Guide: Financial Times Headline API"},"content":{"rendered":"\n<p>At Newcastle University Business School all staff and students have free access to the Financial Times through the library . This allows staff and students to access a number of features of the Financial Times, including developing article lists which can be shared with students, having keyword news alerts for stories on certain subjects, high quality newsletters e-mailed to your inbox on a selection and range of issues. <\/p>\n\n\n\n<p>One of the more powerful tools at a lecturers disposal is the ability to use the free FT Headline API functionality to embed a scrolling and live, constantly updated feed of news stories into a VLE (Be that VLE Canvas or Blackboard). This potentially puts alongside your lecture materials a large amount of contextual, real world, news stories about what is perhaps happening regarding the issues explored in your lecture that week.<\/p>\n\n\n\n<div class=\"wp-block-image\"><figure class=\"aligncenter\"><img loading=\"lazy\" decoding=\"async\" width=\"248\" height=\"537\" src=\"https:\/\/blogs.ncl.ac.uk\/nubsteachinglearningtechnologyforum\/files\/2019\/10\/image-1.png\" alt=\"\" class=\"wp-image-150\" srcset=\"https:\/\/blogs.ncl.ac.uk\/nubsteachinglearningtechnologyforum\/files\/2019\/10\/image-1.png 248w, https:\/\/blogs.ncl.ac.uk\/nubsteachinglearningtechnologyforum\/files\/2019\/10\/image-1-139x300.png 139w\" sizes=\"auto, (max-width: 248px) 100vw, 248px\" \/><\/figure><\/div>\n\n\n\n<p>The above picture is an example of a widget you can embed into your Blackboard site. The rest of this Blog post will lead you through the three main areas to embed this into your Blackboard site.<\/p>\n\n\n\n<p><strong>How to get your free FT Headline API Code<\/strong><\/p>\n\n\n\n<p>The first thing you&#8217;ll need is a FT Developers Key for creating a Headline API. This sounds a lot more grandiose than it really is, and takes just a few straightforward steps: <\/p>\n\n\n\n<ul class=\"wp-block-list\"><li>First make sure your FT Account itself is all set up, and you\u2019ve set an FT password (<a href=\"https:\/\/myaccount.ft.com\/details\/core\/view\">https:\/\/myaccount.ft.com\/details\/core\/view<\/a>).<\/li><\/ul>\n\n\n\n<ul class=\"wp-block-list\"><li>The first thing you\u2019ll need to do is go here: <a href=\"https:\/\/developer.ft.com\/portal\/\">https:\/\/developer.ft.com\/portal\/<\/a> and sign in. Enter your e-mail address and press next, on the next page saying sign in press <strong>under the box<\/strong> saying SSO Sign In <strong>\u201cOr use your FT password\u201d<\/strong>, press that. Then sign in using your <strong>FT password<\/strong>. <\/li><\/ul>\n\n\n\n<ul class=\"wp-block-list\"><li>This takes you to the FT for Developers page. On the right hand side under dashboard it says API Catalogue, click that, the click <strong>\u201cRequest an API Key\u201d<\/strong>.<\/li><\/ul>\n\n\n\n<ul class=\"wp-block-list\"><li>Your new API Headline key will now be shown to you, it will look like a very long line of letters and numbers. Save that and keep it safe. FT will also send you an e-mail with it in to make things easier. <\/li><\/ul>\n\n\n\n<p><strong>Using <a href=\"http:\/\/openft.org\/\">Openft.org<\/a><\/strong><\/p>\n\n\n\n<p><a href=\"http:\/\/openft.org\/\">Openft.org<\/a> is itself is a straightforward and surprisingly user friendly website for creating FT Headline widgets. The first thing you need need to do is<strong> copy and paste <\/strong>you FT API Code into the box saying API Key and then <strong>press reset<\/strong> to clear the form. Pressing <strong>reset<\/strong> after inputting the API key is important, and problems can occur if you don&#8217;t.<\/p>\n\n\n\n<figure class=\"wp-block-image\"><img loading=\"lazy\" decoding=\"async\" width=\"978\" height=\"307\" src=\"https:\/\/blogs.ncl.ac.uk\/nubsteachinglearningtechnologyforum\/files\/2019\/10\/image-4.png\" alt=\"\" class=\"wp-image-156\" srcset=\"https:\/\/blogs.ncl.ac.uk\/nubsteachinglearningtechnologyforum\/files\/2019\/10\/image-4.png 978w, https:\/\/blogs.ncl.ac.uk\/nubsteachinglearningtechnologyforum\/files\/2019\/10\/image-4-300x94.png 300w, https:\/\/blogs.ncl.ac.uk\/nubsteachinglearningtechnologyforum\/files\/2019\/10\/image-4-768x241.png 768w\" sizes=\"auto, (max-width: 767px) 89vw, (max-width: 1000px) 54vw, (max-width: 1071px) 543px, 580px\" \/><\/figure>\n\n\n\n<p>The website should now be ready to create widgets for you. The website has two clear sides to it. The<strong> left hand side<\/strong> is the <strong>input side<\/strong> in which you&#8217;ll input all your desired search options. The <strong>right hand side<\/strong> is the visualisation of the <strong>output<\/strong>, and contains all the tools to further adjust and customise the widget you&#8217;re creating.<\/p>\n\n\n\n<p>You now have a number of different search options. The main three you might use are  Basic Search, Menu and Multi-search. <\/p>\n\n\n\n<p><strong>Menu<\/strong> is useful if you have particular themes you&#8217;re interested in. Just Click on Menu and then you have a number of tick boxes you can click to create a custom widget on Brexit (or similar). <strong>Basic Search<\/strong> is useful if you have a straightforward concept or issue you&#8217;re wanting to drill into.<\/p>\n\n\n\n<p>Increasingly I find myself using <strong>Multi-Search<\/strong>. Multi-Search allows you to search a range of keywords which could bring up articles you&#8217;re interested in. So for example if I was giving a lecture on Ethics and CSR. I may have a range of 4-5 different search terms which I might want the widget to bring back results on. The second search box is a <strong>categorisation box<\/strong> which is helpful look at a particular search term, it defaults to &#8220;All&#8221;.<\/p>\n\n\n\n<figure class=\"wp-block-image\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"421\" src=\"https:\/\/blogs.ncl.ac.uk\/nubsteachinglearningtechnologyforum\/files\/2019\/10\/image-5-1024x421.png\" alt=\"\" class=\"wp-image-158\" srcset=\"https:\/\/blogs.ncl.ac.uk\/nubsteachinglearningtechnologyforum\/files\/2019\/10\/image-5-1024x421.png 1024w, https:\/\/blogs.ncl.ac.uk\/nubsteachinglearningtechnologyforum\/files\/2019\/10\/image-5-300x123.png 300w, https:\/\/blogs.ncl.ac.uk\/nubsteachinglearningtechnologyforum\/files\/2019\/10\/image-5-768x316.png 768w, https:\/\/blogs.ncl.ac.uk\/nubsteachinglearningtechnologyforum\/files\/2019\/10\/image-5.png 1909w\" sizes=\"auto, (max-width: 767px) 89vw, (max-width: 1000px) 54vw, (max-width: 1071px) 543px, 580px\" \/><\/figure>\n\n\n\n<p>On the <strong>right hand output panel<\/strong> the element you&#8217;ll definitely want to use is <strong>Widget Title<\/strong> to give your output search box a name, however there are a wide range of other customisation options for you to explore.<\/p>\n\n\n\n<p>Once you have the widget just how you want it. Simply click <strong>Get Embed Code<\/strong> and copy the bottom box (don&#8217;t worry at all about how complex it looks, you don&#8217;t need to know any coding at all, this is simple copy and paste of this code).<\/p>\n\n\n\n<figure class=\"wp-block-image\"><img loading=\"lazy\" decoding=\"async\" width=\"675\" height=\"412\" src=\"https:\/\/blogs.ncl.ac.uk\/nubsteachinglearningtechnologyforum\/files\/2019\/10\/image-6.png\" alt=\"\" class=\"wp-image-160\" srcset=\"https:\/\/blogs.ncl.ac.uk\/nubsteachinglearningtechnologyforum\/files\/2019\/10\/image-6.png 675w, https:\/\/blogs.ncl.ac.uk\/nubsteachinglearningtechnologyforum\/files\/2019\/10\/image-6-300x183.png 300w\" sizes=\"auto, (max-width: 675px) 100vw, 675px\" \/><\/figure>\n\n\n\n<p><strong>Embedding your Widget into Blackboard<\/strong><\/p>\n\n\n\n<p>Deciding where to place your widget it perhaps the best place to start. I personally place it beside the lecture materials to add some context. The process now you have your embed code is very straightforward. Simply click Build Content, then Create Item.<\/p>\n\n\n\n<p>In the text box now press the HTML Button (see below):<\/p>\n\n\n\n<figure class=\"wp-block-image\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"487\" src=\"https:\/\/blogs.ncl.ac.uk\/nubsteachinglearningtechnologyforum\/files\/2019\/10\/image-7-1024x487.png\" alt=\"\" class=\"wp-image-161\" srcset=\"https:\/\/blogs.ncl.ac.uk\/nubsteachinglearningtechnologyforum\/files\/2019\/10\/image-7-1024x487.png 1024w, https:\/\/blogs.ncl.ac.uk\/nubsteachinglearningtechnologyforum\/files\/2019\/10\/image-7-300x143.png 300w, https:\/\/blogs.ncl.ac.uk\/nubsteachinglearningtechnologyforum\/files\/2019\/10\/image-7-768x365.png 768w, https:\/\/blogs.ncl.ac.uk\/nubsteachinglearningtechnologyforum\/files\/2019\/10\/image-7.png 1268w\" sizes=\"auto, (max-width: 767px) 89vw, (max-width: 1000px) 54vw, (max-width: 1071px) 543px, 580px\" \/><\/figure>\n\n\n\n<p>Now simply paste your embed code from the Openft.org site into the box which pops up and then press <strong>Update.<\/strong><\/p>\n\n\n\n<figure class=\"wp-block-image\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"552\" src=\"https:\/\/blogs.ncl.ac.uk\/nubsteachinglearningtechnologyforum\/files\/2019\/10\/image-8-1024x552.png\" alt=\"\" class=\"wp-image-162\" srcset=\"https:\/\/blogs.ncl.ac.uk\/nubsteachinglearningtechnologyforum\/files\/2019\/10\/image-8-1024x552.png 1024w, https:\/\/blogs.ncl.ac.uk\/nubsteachinglearningtechnologyforum\/files\/2019\/10\/image-8-300x162.png 300w, https:\/\/blogs.ncl.ac.uk\/nubsteachinglearningtechnologyforum\/files\/2019\/10\/image-8-768x414.png 768w, https:\/\/blogs.ncl.ac.uk\/nubsteachinglearningtechnologyforum\/files\/2019\/10\/image-8.png 1632w\" sizes=\"auto, (max-width: 767px) 89vw, (max-width: 1000px) 54vw, (max-width: 1071px) 543px, 580px\" \/><\/figure>\n\n\n\n<p>Then just name your Item (Context: Business Ethics in the News or similar), and press <strong>Submit<\/strong>. You can now move this item around  just like you would any other Blackboard or VLE item. <\/p>\n\n\n\n<p>I hope you&#8217;ve found this &#8220;How-to&#8221; Guide useful! Please leave any tips or comments in the comments section below.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>At Newcastle University Business School all staff and students have free access to the Financial Times through the library . This allows staff and students to access a number of features of the Financial Times, including developing article lists which can be shared with students, having keyword news alerts for stories on certain subjects, high &hellip; <\/p>\n<p class=\"link-more\"><a href=\"https:\/\/blogs.ncl.ac.uk\/nubsteachinglearningtechnologyforum\/2019\/10\/25\/how-to-financial-times-headline-api\/\" class=\"more-link\">Continue reading<span class=\"screen-reader-text\"> &#8220;How-to Guide: Financial Times Headline API&#8221;<\/span><\/a><\/p>\n","protected":false},"author":4071,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[8],"tags":[10,11,12,6],"class_list":["post-136","post","type-post","status-publish","format-standard","hentry","category-how-to-guide","tag-financial-times","tag-ft-headline-api","tag-how-to","tag-technology"],"_links":{"self":[{"href":"https:\/\/blogs.ncl.ac.uk\/nubsteachinglearningtechnologyforum\/wp-json\/wp\/v2\/posts\/136","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/blogs.ncl.ac.uk\/nubsteachinglearningtechnologyforum\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blogs.ncl.ac.uk\/nubsteachinglearningtechnologyforum\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blogs.ncl.ac.uk\/nubsteachinglearningtechnologyforum\/wp-json\/wp\/v2\/users\/4071"}],"replies":[{"embeddable":true,"href":"https:\/\/blogs.ncl.ac.uk\/nubsteachinglearningtechnologyforum\/wp-json\/wp\/v2\/comments?post=136"}],"version-history":[{"count":21,"href":"https:\/\/blogs.ncl.ac.uk\/nubsteachinglearningtechnologyforum\/wp-json\/wp\/v2\/posts\/136\/revisions"}],"predecessor-version":[{"id":178,"href":"https:\/\/blogs.ncl.ac.uk\/nubsteachinglearningtechnologyforum\/wp-json\/wp\/v2\/posts\/136\/revisions\/178"}],"wp:attachment":[{"href":"https:\/\/blogs.ncl.ac.uk\/nubsteachinglearningtechnologyforum\/wp-json\/wp\/v2\/media?parent=136"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blogs.ncl.ac.uk\/nubsteachinglearningtechnologyforum\/wp-json\/wp\/v2\/categories?post=136"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blogs.ncl.ac.uk\/nubsteachinglearningtechnologyforum\/wp-json\/wp\/v2\/tags?post=136"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}