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 geocoding 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:
https://api.apilayer.net/positionstack/v1/forward?access_key=YOUR_ACCESS_KEYImportant: 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:
curl "https://api.apilayer.net/positionstack/v1/forward?access_key=YOUR_ACCESS_KEY&query=Eiffel Tower"Example Response:
{
"data": [
{
"latitude": 48.8582602,
"longitude": 2.2944991,
"label": "Eiffel Tower, Paris, France",
"country": "France"
}
]
}Step 3: Reverse Geocoding (Coordinates → Address)
Use the /reverse endpoint to look up an address from latitude and longitude.
Example Request:
curl "https://api.apilayer.net/positionstack/v1/reverse?access_key=YOUR_ACCESS_KEY&query=48.8584,2.2945"Example Response:
{
"data": [
{
"label": "Eiffel Tower, Paris, France",
"country": "France",
"region": "Île-de-France"
}
]
}Step. 4: Optional Parameters
You can refine your queries using optional parameters:
limit– control the number of resultscountry– restrict results to a specific countrylanguage– specify result language (e.g.,en,fr,es)output– choose betweenjsonandxml
Example:
https://api.apilayer.net/positionstack/v1/forward?access_key=YOUR_ACCESS_KEY&query=Berlin&country=DE&limit=3Support & Resources
- Explore commonly used API calls and examples to get the most out of your integration.
- For any assistance, contact our support team anytime.