Quickstart Guide

All registered users, whether on a free or paid plan, can use our Quickstart Guide to explore the full range of API functionalities with just one click.

• Existing users: Access the Quickstart Guide below.
• New users: Create an account and get started in minutes.

Get onboarded with the Positionstack API and start retrieving aviation data immediately!

Step 1: Sign Up and Get Your API Key

Each registered Positionstack account is associated with a unique API access key, which is used to authenticate with the API when geocoding. You can find your personal API access key in your account dashboard.

To start making API requests, please authenticate with the API using the example request below.

Example:

Important: Always keep your API access key secure. If you suspect unauthorized use, you can easily revoke and generate a new key from your account dashboard.

Step 2: Forward Geocoding (Address → Coordinates)

Use the /forward endpoint to convert a physical address into latitude and longitude coordinates.

Example Request:

Example Response:

Step 3: Reverse Geocoding (Coordinates → Address)

Use the /reverse endpoint to look up an address from latitude and longitude.

Example Request:

Example Response:

Step. 4: Optional Parameters

You can refine your queries using optional parameters:

• limit – control the number of results
• country – restrict results to a specific country
• language – specify result language (e.g., en, fr, es)
• output – choose between json and xml

Example:

Positionstack on GitHub

• For any assistance, contact our support team anytime.