How to Temboo with cURL

Temboo makes it easy to build applications that connect to over 100 web-based resources and services (e.g., Facebook, Dropbox, US Census data) by standardizing how you interact with their Application Programming Interfaces (APIs). Don't worry if you're not familiar with APIs – with Temboo you don't have to worry about the details.

Here we'll show you how to use the Temboo REST API - a great option if we don't have an SDK in your favorite programming language yet. You can learn all about it in this video.

In this tutorial we'll write a simple cURL command that uses Google's Geocoding API to retrieve information for a specific address, e.g., 104 Franklin Street, New York City. What makes Temboo uniquely powerful and useful is that once you know how to use one API, you know how to work with any API in our Library.

Before we get started, make sure that you've got cURL installed on your system.

Get Set up

1 Log in to Temboo. If you don't already have an account, you can register for free here.

Test on our website

2 Go to the Google > Geocoding > GeocodeByAddress Choreo in our Library.

3 Enter any address or ZIP code in the Address input field, e.g., 104 Franklin Street, New York City.

4 Now click Run. After a moment you'll see the data that Yahoo sends back shown in the Output section.

Auto-Generate The curl command

When you run any Choreo from our website, we automatically generate code that can be used to make the same API call many languages. For languages we don't yet have an SDK for, we generate cURL commands, and you can learn how to use them below.

5 Scroll down to the Code section of the Library page, click on the Language drop-down menu, and select cURL.

At this point, your script should look something like this:

curl --basic -u APP_NAME:APP_KEY --header "x-temboo-domain: /ACCOUNT_NAME/master" --header "Content-Type: application/json" --header "Accept: application/json" -X POST --data '{"inputs": [{"name":"Address", "value":"104 Franklin Street, New York City"}]}' ""

Try It Out

6Now you're ready to run the script and see the output. Copy the cURL script and paste it into your terminal or console. If all goes according to plan, you should see an XML response from Google.

What next?

Congrats! You just ran your first Choreo! Now you're ready to run any of our 2000+ Choreos with cURL. You're just a few steps away from making something extraordinary.

Once you've got your code up and running, you're ready to move on and do more. From monitoring your running applications, to moving your generated Temboo code to your preferred development environment and sharing it with colleagues, collaborators and friends - we've got you covered.

Get Live Updates About Your Application

Integrate Temboo with Slack to get up-to-the-second notifications and alerts about your deployed Temboo code.

Commit Code to GitHub

Commit Temboo-generated code directly to GitHub and share with the world. Learn more.

Need help?

We're always happy to help. Just email us at, and we'll answer your questions.