Postman Geocoding Tutorial

Accessing our API inside Postman

Postman is an application designed to make developing against APIs simpler. To be honest, our API is very straight-forward, with only a single entry point and authentication via the key parameter you supply as a variable in your request. Many APIs are more complex, and Postman can be a great tool for interacting with them.

Still, we thought it might be useful to publish a Postman "collection" to help anyone who wants to access our API via this tool.

  1. Sign up for an OpenCage Geocoder API key, or if you already have one log in.
  2. Download and install the Postman application from the Postman website.

  3. Create a Postman account

  4. Import the OpenCage collection into your Postman application by clicking this button: Run in Postman

  5. The "OpenCage Geocoder" collection should now appear in your app.

  6. When you click on the collection name, you will see the collection has one request called "json geocoding request". Click on it.

  7. One of the request parameters is a variable {{APIKEY}} which is currently unresolved (ie empty or undefined)

  8. You need to create an environment in which you define a value for {{APIKEY}}

  9. Add an environment (in this example it is named "OpenCage") and define a variable named "APIKEY", set the value to your OpenCage API key.

  10. Save the environment, close it, and select it

  11. Now click "Send" and you should see a response from the OpenCage Server

  12. Happy geocoding!
Start your free trial

2,500 API requests per day.

No credit card required.