@william5553/wolframalpha

wolframalpha is a very thin wrapper for the WolframAlpha API. It merely makes queries and returns the answer in JSON (converted from their usual XML). The conversion is done with node-xml2js and nothing else is done.

Updated version of node-wolfram by rahatarmanahmed which was a rewrite of node-wolfram by strax.

Install

npm install @william5553/wolframalpha

Usage

Here is an example in JavaScript:

const Client = require('@william5553/wolframalpha');
const Wolfram = new Client('YOUR_APPID_HERE');
Wolfram.query('2+2', function(err, result) {
	if (err)
		console.log(JSON.stringify(err));
	else
	{
		for(let a = 0; a < result.queryresult.pod.length; a++)
		{
			const pod = result.queryresult.pod[a];
			console.log(pod.$.title,": ");
			for(let b = 0; b < pod.subpod.length; b++)
			{
				const subpod = pod.subpod[b];
				for(let c = 0; c < subpod.plaintext.length; c++)
				{
					const text = subpod.plaintext[c];
					console.log('\t', text);
				}
			}
		}
	}
});

It will output:

Input: 
	 2+2
Result: 
	 4
Number name: 
	 four
Number line: 
	 
Manipulatives illustration: 
	  | + |  |  =  | 
2 |  | 2 |  | 4
Typical human computation times: 
	 age 6:  3.2 seconds  |  age 8:  1.8 seconds  |  age 10:  1.2 seconds  |  
age 18:  0.83 seconds
(ignoring concentration, repetition, variations in education, etc.)

If the request or xml2js conversion has an error, the callback will receive that error. If the query is received, but the queryresult has an error property, then the error given to the callback will be that queryresult's error.

Example Response

This is what you get for the response if you query 2+2. It should help show how the XML response gets converted to JSON. Attributes of tags are stored in the $ properties.

{
    "queryresult": {
        "$": {
            "success": "true",
            "error": "false",
            "numpods": "6",
            "datatypes": "Math",
            "timedout": "",
            "timedoutpods": "",
            "timing": "0.671",
            "parsetiming": "0.076",
            "parsetimedout": "false",
            "recalculate": "",
            "id": "MSPa264521a0e4dg83gd7eg200005037925gie85ce02",
            "host": "http://www5a.wolframalpha.com",
            "server": "29",
            "related": "http://www5a.wolframalpha.com/api/v2/relatedQueries.jsp?id=MSPa264621a0e4dg83gd7eg200003a3da730hhbdgifi&s=29",
            "version": "2.6"
        },
        "pod": [{
            "$": {
                "title": "Input",
                "scanner": "Identity",
                "id": "Input",
                "position": "100",
                "error": "false",
                "numsubpods": "1"
            },
            "subpod": [{
                "$": {
                    "title": ""
                },
                "plaintext": ["2+2"],
                "img": [{
                    "$": {
                        "src": "http://www5a.wolframalpha.com/Calculate/MSP/MSP264721a0e4dg83gd7eg20000519g66800ac2e7bg?MSPStoreType=image/gif&s=29",
                        "alt": "2+2",
                        "title": "2+2",
                        "width": "32",
                        "height": "18"
                    }
                }]
            }]
        }, {
            "$": {
                "title": "Result",
                "scanner": "StepByStep",
                "id": "Result",
                "position": "200",
                "error": "false",
                "numsubpods": "1",
                "primary": "true"
            },
            "subpod": [{
                "$": {
                    "title": ""
                },
                "plaintext": ["4"],
                "img": [{
                    "$": {
                        "src": "http://www5a.wolframalpha.com/Calculate/MSP/MSP264821a0e4dg83gd7eg2000033434gf1i1cfc47h?MSPStoreType=image/gif&s=29",
                        "alt": "4",
                        "title": "4",
                        "width": "8",
                        "height": "18"
                    }
                }]
            }],
            "states": [{
                "$": {
                    "count": "1"
                },
                "state": [{
                    "$": {
                        "name": "Step-by-step solution",
                        "input": "Result__Step-by-step solution"
                    }
                }]
            }]
        }, {
            "$": {
                "title": "Number name",
                "scanner": "Integer",
                "id": "NumberName",
                "position": "300",
                "error": "false",
                "numsubpods": "1"
            },
            "subpod": [{
                "$": {
                    "title": ""
                },
                "plaintext": ["four"],
                "img": [{
                    "$": {
                        "src": "http://www5a.wolframalpha.com/Calculate/MSP/MSP264921a0e4dg83gd7eg2000026f0i2b652da2991?MSPStoreType=image/gif&s=29",
                        "alt": "four",
                        "title": "four",
                        "width": "28",
                        "height": "18"
                    }
                }]
            }]
        }, {
            "$": {
                "title": "Number line",
                "scanner": "NumberLine",
                "id": "NumberLine",
                "position": "400",
                "error": "false",
                "numsubpods": "1"
            },
            "subpod": [{
                "$": {
                    "title": ""
                },
                "plaintext": [""],
                "img": [{
                    "$": {
                        "src": "http://www5a.wolframalpha.com/Calculate/MSP/MSP265021a0e4dg83gd7eg20000393ii8ihd6575ib6?MSPStoreType=image/gif&s=29",
                        "alt": "",
                        "title": "",
                        "width": "300",
                        "height": "51"
                    }
                }]
            }]
        }, {
            "$": {
                "title": "Manipulatives illustration",
                "scanner": "Arithmetic",
                "id": "Illustration",
                "position": "500",
                "error": "false",
                "numsubpods": "1"
            },
            "subpod": [{
                "$": {
                    "title": ""
                },
                "plaintext": [" | + |  |  =  | \n2 |  | 2 |  | 4"],
                "img": [{
                    "$": {
                        "src": "http://www5a.wolframalpha.com/Calculate/MSP/MSP265121a0e4dg83gd7eg20000596ci7a3i5064882?MSPStoreType=image/gif&s=29",
                        "alt": " | + |  |  =  | \n2 |  | 2 |  | 4",
                        "title": " | + |  |  =  | \n2 |  | 2 |  | 4",
                        "width": "134",
                        "height": "48"
                    }
                }]
            }]
        }, {
            "$": {
                "title": "Typical human computation times",
                "scanner": "Arithmetic",
                "id": "TypicalHumanComputationTimes",
                "position": "600",
                "error": "false",
                "numsubpods": "1"
            },
            "subpod": [{
                "$": {
                    "title": ""
                },
                "plaintext": ["age 6:  3.2 seconds  |  age 8:  1.8 seconds  |  age 10:  1.2 seconds  |  \nage 18:  0.83 seconds\n(ignoring concentration, repetition, variations in education, etc.)"],
                "img": [{
                    "$": {
                        "src": "http://www5a.wolframalpha.com/Calculate/MSP/MSP265221a0e4dg83gd7eg20000647fdi2ce1ce2f8e?MSPStoreType=image/gif&s=29",
                        "alt": "age 6:  3.2 seconds  |  age 8:  1.8 seconds  |  age 10:  1.2 seconds  |  \nage 18:  0.83 seconds\n(ignoring concentration, repetition, variations in education, etc.)",
                        "title": "age 6:  3.2 seconds  |  age 8:  1.8 seconds  |  age 10:  1.2 seconds  |  \nage 18:  0.83 seconds\n(ignoring concentration, repetition, variations in education, etc.)",
                        "width": "485",
                        "height": "63"
                    }
                }]
            }],
            "states": [{
                "$": {
                    "count": "1"
                },
                "state": [{
                    "$": {
                        "name": "More details",
                        "input": "TypicalHumanComputationTimes__More details"
                    }
                }]
            }]
        }],
        "sources": [{
            "$": {
                "count": "1"
            },
            "source": [{
                "$": {
                    "url": "http://www.wolframalpha.com/sources/HumanComputationQuerySourceInformationNotes.html",
                    "text": "Human computation query"
                }
            }]
        }]
    }
}