Free
For testing and side projects
$0forever
No credit card
No overage charges
100 requests / month
Includes:
- Forward Geocoding
- Reverse Geocoding
- HTTPS Encryption
- Country Module
+ 4 more
See all 16 featuresAccurate Address-to-Coordinate Conversion API · by APILayer
Free plan · 100 requests / month · no card
Overview
Positionstack is a free, real-time geocoding API that powers address validation and location services for developers and businesses worldwide. It delivers accurate forward and reverse geocoding for over 2 billion places and addresses in a lightweight JSON format.
curl --request GET \
--url "https://api.apilayer.net/positionstack/v1/forward?access_key=YOUR_ACCESS_KEY&query=1600%20Pennsylvania%20Ave%20NW,%20Washington%20DC"
{
"data": {
"results": [
{
"latitude": 40.763841,
"longitude": -73.972972,
"label": "Apple Store, Manhattan, New York, NY, USA",
"name": "Apple Store",
"type": "venue",
"distance": 0,
"number": "767",
"street": "5th Avenue",
"postal_code": "10153",
"confidence": 1,
"region": "New York",
"region_code": "NY",
"administrative_area": null,
"neighbourhood": "Midtown East",
"country": "United States",
"country_code": "US",
"map_url": "https://positionstack.com/download/map.html?bbox=-73.972472,40.764341,-73.973472,40.763341&marker=40.763841,-73.972972"
}
]
}
}Effortlessly convert any global address into precise coordinates (forward geocoding) or transform latitude and longitude values into readable address data (reverse geocoding). This dual capability supports everything from map plotting to user location verification.
Process geocoding requests in real-time with response times ranging between 10 and 100 milliseconds. The API is built on a scalable cloud infrastructure capable of handling more than 1 billion daily lookup requests without compromising speed.
Access a massive dataset of over 2 billion addresses and places around the world, sourced from high-quality data vendors and updated multiple times per day. Positionstack covers accurate location data for every country, ensuring your application works globally.
Beyond simple coordinates, retrieve comprehensive location components including country, timezone, and sun module data. You can also instantly generate embeddable maps using the API’s returned map URLs.
Pricing
Start free. Upgrade when you go live.
For testing and side projects
$0forever
No credit card
No overage charges
100 requests / month
Includes:
+ 4 more
See all 16 featuresFor your first live product
$9.99/ month
Billed monthly
Then $0.0003996 per extra request, up to 200,000 extra a month
100,000 requests / month
Everything in Free, plus:
+ 2 more
See all 16 featuresFor growing traffic
$49.99/ month
Billed monthly
Then $0.00019996 per extra request, up to 2,000,000 extra a month
1,000,000 requests / month
Everything in Starter, plus:
For high volume
$99.99/ month
Billed monthly
Then $0.00013332 per extra request, up to 6,000,000 extra a month
3,000,000 requests / month
Everything in Professional, plus:
Need more? Contact sales for custom needs.
| 16 features | Free$0Get free key | Starter$9.99/moSubscribe | Professional$49.99/moSubscribe | Enterprise$99.99/moSubscribe |
|---|---|---|---|---|
| Forward Geocoding | ||||
| Reverse Geocoding | ||||
| HTTPS Encryption | ||||
| Country Module | ||||
| Sun Module | ||||
| Timezone Module | ||||
| Bounding Box Module | ||||
| Specify Response Fields | ||||
| Commercial License | – | |||
| Extended Rate Limits | – | |||
| XML & GeoJSON Output | – | |||
| Embeddable Maps | – | |||
| Multiple Languages Support | – | |||
| Batch Requests | – | – | ||
| Standard Support included | – | |||
| Custom Solutions / Volume | – | – | – | – |
| Price per extra request after the monthly limit | None | $0.0003996 | $0.00019996 | $0.00013332 |
Playground
Build a request in your browser and see the response it returns.
Agents
Steps for AI coding agents that add Positionstack to a project.
A person creates the account: an agent cannot sign up. Sign up at app.apilayer.com and subscribe to Positionstack. The Free plan includes 100 requests / month and needs no credit card.
Copy the API key from the APILayer dashboard and give it to the agent as an environment variable (step 2).
Read the key from an environment variable named APILAYER_ACCESS_KEY. Do not write the key into source code, commit it to git, or paste it into a chat.
Call Positionstack from server code. The key travels in the request URL, so a request sent from a browser shows the key to every visitor.
# add .env to .gitignore
APILAYER_ACCESS_KEY=your_api_keyhttps://api.apilayer.net/positionstack/v1access_key query parameter/forward Forward geocoding/reverse Reverse geocodingcurl "https://api.apilayer.net/positionstack/v1/forward?access_key=$APILAYER_ACCESS_KEY&query=1600%20Pennsylvania%20Ave%20NW,%20Washington%20DC"The API info tab shows the response this request returns.
Each plan adds features to the plan before it. Check that the account's plan includes a feature before writing code that uses it.
| Plan | Requests / month | Adds |
|---|---|---|
| Free | 100 | Forward Geocoding, Reverse Geocoding, HTTPS Encryption, Country Module, Sun Module, Timezone Module, Bounding Box Module, Specify Response Fields |
| Starter | 100,000 | Commercial License, Extended Rate Limits, XML & GeoJSON Output, Embeddable Maps, Multiple Languages Support, Standard Support included |
| Professional | 1,000,000 | Batch Requests |
| Enterprise | 3,000,000 | Same features as Professional |
Prices are in the Pricing tab.
FAQs
Here are the answers you might be seeking
Reverse geocoding is the process of converting geographic coordinates (latitude and longitude) into a readable text address. It allows you to identify the specific location name, street, or city associated with a set of coordinates.
Positionstack is designed for everyone, from individual developers and startups to large enterprises. It scales to support thousands of web applications, mobile apps, and mapping services worldwide.
The API was built to offer an affordable and straightforward REST API interface for global forward and reverse geocoding in real-time, supporting nearly all countries worldwide with more than two billion global addresses covered. The API is making use of a number of trusted data sources to provide a high level of accuracy for every geocoding API request made. If you are interested in trying out the API, simply create a free account and be up and running within minutes.
Geocoding data returned by the positionstack API is sourced from multiple, highly reliable sources, such as Nominatim, GeoNames, Pelias and OpenStreetMap. Updates to our dataset are made multiple times per day and smart filters and algorithms ensure the highest possible level of consistency across API requests and accuracy in geo data responses.
Forward geocoding is the process of looking up a plain-text address or place name (e.g. Eiffel Tower), whereas reverse geocoding is performed by passing latitude and longitude values of a desired location to the API. If successful, both types of geocoding return an extensive array of location-related data as well as multiple potential results along with confidence scores.
The positionstack API supports all countries worldwide. However, some countries come with better coverage than others, which is also the case for locations within a specific country. By combining and cross-checking multiple reputable geo data sources, our API does a great job at finding the exact location you are looking for, at any point.
To make a forward geocoding request, send a request to the /forward endpoint with your access key and query. Example: http://api.positionstack.com/v1/forward?access_key=YOUR_ACCESS_KEY&query=Eiffel Tower.
To make a reverse geocoding request, send a request to the /reverse endpoint using comma-separated coordinates. Example: http://api.positionstack.com/v1/reverse?access_key=YOUR_ACCESS_KEY&query=48.8584,2.2945.
APILayer has unified documentation for all products. You can find the full API documentation, including integration guides, code examples, and endpoint details, on our documentation page
One API request is consumed every time the positionstack API returns geocoding data, regardless of which endpoint was used for your request. If your request is unsuccessful and returns an error instead, your quota will not be affected.
Users will be automatically notified via e-mail and on their Account Dashboard once at least 75%, 90%, and 100% of their monthly API Request allowance has been reached. After reaching 100% of the allowance, overages fees will apply so we make sure you won’t experience any disruptions and your website/application will keep running smoothly.
Our API's system status is closely monitored around the clock. Every effort is made to ensure the highest possible level of availability and consistency, and we are proud to have an average uptime rate of nearly 100% (99.9%), calculated based on the past 12 months.
Yes, Positionstack offers a free geocoding API plan for personal use. It includes 100 free requests per month, forward geocoding, reverse geocoding, and HTTPS encryption, with no technical support included.
Yes. If you choose annual billing, the total price of your subscription plan will be up to 15% lower than the total amount you would pay with a monthly payment frequency.
An overage occurs when you go over a quota for your API plan. When you reach your API calls limit, we will charge you a small amount for each new API call so we can make sure there will be no disruption in the service we provide to you and your website or application can continue running smoothly.
Prices for additional API calls will vary based on your plan.
Overage fees allow customers to continue using an API once a quota limit is reached. We want to make sure your website or application continues running at all times, so charges will apply if you go over your monthly quota limit. If you notice you are going over your quota limit each month, look on your dashboard for an upgraded plan to help with larger request limits.
When you are close to reaching your API calls limit for the month, you will receive an automatic notification (at 75%, 90%, and 100% of your monthly quota). You can keep track of your quota usage to prevent overages by tracking the number of API calls you make and checking the dashboard for up-to-date usage statistics.
If your usage consistently surpasses the set limits each month, you may face additional charges for the excess usage. Nevertheless, as your monthly usage reaches a certain threshold, it becomes more practical to consider upgrading to the next plan. By doing so, you ensure a smoother and more accommodating experience for your growing customer base.
Still have a question?
Contact support