update 11\/02\/2014 – in process of updating and checking examples – but we know for sure that the Twitter examples are broken.<\/p>\n
This post is a collection of many examples of using curl (from a terminal command line) to make API requests. The ones marked with* will run without passwords or api-keys. The responses will generally be in XML, JSON, or HTML<\/p>\n
Some of these curl examples will have API keys, user names, and passwords. To run them, you’ll need to replace the keys with your own.<\/p>\n
Also, when running from the command line, ampersands ‘&’ will need to be escaped by preceding them with a backslash, like \\&<\/p>\n
Other characters may need to be escaped, like:<\/p>\n
%23 = #<\/p>\n
%40 = @<\/p>\n
Or you can wrap the entire URL is quotes like this:<\/p>\n
curl "dict:\/\/dict.org\/d:penguin"<\/pre>\ntips for finding curl examples<\/h5>\n
Look in the address bar of your web browser. Copy the entire URL and run it in curl. It will respond with the ‘text’ version of the web page.<\/p>\n
displaying JSON on the command line<\/h4>\n
The respond from curl is raw data. To format JSON data, pipe the output through python, like this:<\/p>\n
curl dict:\/\/dict.org\/d:dog | python -mjson.tool<\/pre>\nexamples:<\/h4>\n
dict.org*<\/h5>\n
curl dict:\/\/dict.org\/d:antelope<\/pre>\nTwitter search (broken)<\/h5>\n
Twtitter API now requires authentication and will not run from a single curl command, except by using widgets. See this post:\u00a0https:\/\/reactivemusic.net\/?p=17428<\/a><\/p>\n
openweathermap.com*<\/h5>\n
curl http:\/\/api.openweathermap.org\/data\/2.1\/forecast\/city\/524901\r\n\r\n<\/pre>\nSee this post for details:\u00a0https:\/\/reactivemusic.net\/?p=6265<\/a><\/p>\n
vine.com*<\/h5>\n
curl https:\/\/api.vineapp.com\/timelines\/popular<\/pre>\nmashape.com API<\/h5>\n
Here’s an example of a typical API call which gets the weather in San Francisco. Note I have obscured the API-key.<\/p>\n
curl -H "X-Mashape-Authorization: YOUR-MASHAPE-KEY" "https:\/\/george-vustrey-weather.p.mashape.com\/api.php?_method=getForecasts&location=San%20Francisco"<\/pre>\nHere’s the result:<\/p>\n
[{"day_of_week":"Wed","high":"63","low":"47","condition":"Mostly Clear"},{"day_of_week":"Thu","high":"66","low":"50","condition":"Partly Cloudy"}]<\/pre>\n[Note] more examples in tkzic\/mashape<\/p>\n
dictionaryapi.com<\/h5>\n
Here is an example of a request to the Thesaurus API<\/p>\n
curl http:\/\/www.dictionaryapi.com\/api\/v1\/references\/thesaurus\/xml\/cheese?key=ee2466d2-07a0-40af-b959-abcdeb125f0ca<\/pre>\n<\/p>\n
*pandorabots.com<\/h5>\n
Here are two examples I just got to work using curl<\/p>\n
curl -X POST --data "botid=b0dafd24ee35a477&input=hello" http:\/\/www.pandorabots.com\/pandora\/talk-xml\r\n\r\ncurl -X POST --data "botid=b0dafd24ee35a477&input=Where are you?" http:\/\/www.pandorabots.com\/pandora\/talk-xml<\/pre>\nHere is the result for the second question<\/div>\n<\/div>\n\n<result status="0" botid="b0dafd24ee35a477" custid="b3422b612633ac87"><input>Where are you?<\/input><that>I am in the computer at Pandorabots.com.<\/that><\/result><\/pre>\n<\/div>\n*more pandorabots.com<\/h5>\n
curl -X POST --data "botid=b0dafd24ee35a477&input=hello" http:\/\/www.pandorabots.com\/pandora\/talk-xml\r\n\r\ncurl -X POST --data "botid=b0dafd24ee35a477&input=Where are you?" http:\/\/www.pandorabots.com\/pandora\/talk-xml\r\n\r\ncurl -X POST --data "botid=b0dafd24ee35a477&input=Lets play some music today." http:\/\/www.pandorabots.com\/pandora\/talk-xml<\/pre>\nGoogle speech API (may be broken – need to check the key)<\/h5>\n
This is an example of the curl command to run from the command line<\/p>\n
the test.flac file is located in tkzic\/speech – it contains a recording of the phrase “there are turtles wandering through the city”. If you click on the file it will play through audacity.<\/p>\n
curl \\\r\n --data-binary @test.flac \\\r\n --header 'Content-type: audio\/x-flac; rate=16000' \\\r\n 'https:\/\/www.google.com\/speech-api\/v1\/recognize?xjerr=1&client=chromium&pfilter=2&lang=en-US&maxresults=6'<\/pre>\ncosm.com (may be broken)<\/h5>\n
Today I was finally able to get this working. Reading a Cosm (Pachube) feed from curl and from Max. Here is an example that works in curl: (replace API-KEY with actual key)<\/p>\n
curl http:\/\/api.cosm.com\/v2\/feeds\/76490\/datastreams\/Power.xml?key=API-KEY<\/pre>\nYou can get JSON responses by leaving off the .xml extension or replacing it with .json<\/p>\n
Its critical to use “key=…” not “X-ApiKey=…” like in the cosm documentation, or you will get permission errors from curl and Max.<\/p>\n
Youtube.com v3 API<\/h5>\n