When you set up an account, you can activate one of these APIs on your account through the portal:
\n![\"\"](\"http:\/\/172.104.26.128\/wp-content\/uploads\/2016\/05\/img_5726b46cf3add.png\")
<\/p>\n
Note that if you use the free version they require you to include sourcing in your application:<\/p>\n
Usage Restrictions\n\nUsage of AlchemyAPI should abide by the restrictions of your respective API tier. Approved academic users are permitted to make a maximum of 30,000 API calls each day (or 1,000 daily calls for commercial use). More daily API calls (up to 200,000,000 daily) are available through an AlchemyAPI Subscription Plan.\n\nUsers of the AlchemyAPI Free service tier must provide proper attribution within their website or application:\n\nProvide a clickable hyperlink to www.alchemyapi.com with the text \"Text Analysis by AlchemyAPI\" within your website or application; and\n\nProvide attribution to AlchemyAPI within any published works that are based on or mention AlchemyAPI, or content generated by AlchemyAPI, including but not limited to research papers and journal articles.\n\nProvide attribution to AlchemyAPI within all web pages or documents where AlchemyAPI content and\/or API results are used or displayed.\n\nOther usage restrictions are listed in the AlchemyAPI Terms of Use policy.\n<\/pre>\nWhen you call this API, you just need an API key, and then a payload of request parameters:<\/p>\n
let apiCall = {\n apikey: apikey,\n text: text,\n outputMode: 'json',\n showSourceMode: 0\n};\n\npost('https:\/\/gateway-a.watsonplatform.net' + baseUrl + endpoint,\n {form: apiCall},\n (err, response, body) => {\n if (!!err) {\n console.log(err); \n }\n \n writeFile(\n filename,\n body\n ); \n }\n);\n<\/pre>\nI like to write each API call out to it’s own JSON file – this way I don’t risk calling the same API call multiple times and wasting resources, so around the above code I leave a check to make sure that the API output isn’t already downloaded:<\/p>\n
let filename: string = \n \"json\/watson\/\" + field + \"_\" + endpoint + \"_\" + id + \".json\";\n\nif (existsSync(filename)) {\n console.log(\"Skipping \" + filename);\n} else {\n console.log(\"Analyzing \" + filename);\n\n ... \n}\n<\/pre>\nWhen I do this, I’m starting from a folder where I have a series of JSON files I want to analyse. To do this, you need to read the folder:<\/p>\n
readdir(\"json\/1\",\n (err, files) => {\n process(files, 1, () => {console.log(\"finished!\")});\n });\n<\/pre>\nThen the “process” function is recursive, or else you get a “too many open files” error.<\/p>\n
function process(files, i, finish) {\n let filename = files[i];\n let id = (filename.split(\".\"))[0];\n \n readFile(\n \"json\/1\/\" + filename,\n (err, content) => { \n fields.map(\n (field) => {\n apiCalls.map(\n (endpoint) => \n Try( () => { \n if (!!err) { \n console.log(err);\n return;\n }\n \n let json: string = JSON.parse(content + '');\n let text: string = json[field];\n \n analyze(field, endpoint, id, text);\n \n if (i < files.length) {\n process(files, i + 1, finish);\n } else {\n finish();\n }\n }, \"Parsing file \" + id) \n )\n })\n });\n}\n<\/pre>\nWhen this runs successfully, you get output that looks like the following example – this is using the transcript from a university lecture. I did find it a little disappointing that this only gives you a single data value, where the Watson demo gives you hundreds, so it appears that you pay for every data point that you get out.<\/p>\n
{\n \"status\": \"OK\",\n \"usage\": \"By accessing AlchemyAPI or using information generated by AlchemyAPI, you are agreeing to be bound by the AlchemyAPI Terms of Use: http:\/\/www.alchemyapi.com\/company\/terms.html\",\n \"totalTransactions\": \"1\",\n \"language\": \"english\",\n \"docSentiment\": {\n \"mixed\": \"1\",\n \"score\": \"0.214952\",\n \"type\": \"positive\"\n }\n}\n<\/pre>\nIf you run this too many times, you’ll get an API call that looks like this:<\/p>\n
{\n \"status\": \"ERROR\",\n \"statusInfo\": \"daily-transaction-limit-exceeded\"\n}\n<\/pre>\nThis is a bit of a pain, because you can get a lot of these (the sentiment API is quite fast, so it takes less than a minute to run out of calls).<\/p>\n
When running this, I found it was helpful to inject a logging utility to print out HTTP calls – this helps in the event you screw up something in the Node library to do external requests:<\/p>\n
requestLogger(require('https'));\n<\/pre>\n","protected":false},"excerpt":{"rendered":"A basic node example that shows how to access the IBM Watson API<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"om_disable_all_campaigns":false,"_monsterinsights_skip_tracking":false,"footnotes":""},"categories":[6,21],"tags":[53,302,378,385,387,388,557,583],"aioseo_notices":[],"aioseo_head":"\n\t\t\n\t\n\t\n\t\n\t\n\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t