What is positionstack?

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.

Who runs the API?

The positionstack API is part of the apilayer ecosystem and sits next to 20+ other microservice APIs currently on the market, including currencylayer for exchang rate data, serpstack for SERP data scraping and ipapi for IP geolocation data. You can learn more about apilayer by clicking the link at the bottom of the page.

How scalable is the positionstack API?

Thanks to apilayer's scalable cloud infrastructure positionstack is hosted on, the API is capable of handling anything from hundreds of API lookups per month all the way to millions of geocoding requests per hour. Depending on which subscription plan you choose, you will be able to access the API with a strict, extended or even completely flexible rate limit.

How accurate is positionstack geocoding data?

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.

What is the difference between forward and reverse geocoding?

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.

Can I embed a map in my website?

Yes, if embeddable maps are supported on your subscription plan you will be able to make use of an API response object named "map_url" containing a URL that can be embedded on your website using an iFrame.

Which countries are supported?

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.

Can I look up multiple locations in one API request?

Yes, batch requests (using HTTP POST) are supported by the API on the Professional Plan and higher. You can learn more about batch requests by jumping to our API Documentation.

Which payment methods are supported?

Payments for the positionstack API can be made via all major credit card providers (Visa, MasterCard, Discover, Diner's Club, American Express). Enterprise and large-volume customers may request annual bank transfer payments to be enabled. You can change your payment method at any point in time in the "Payment" section of your account dashboard.

Can I also pay yearly?

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.

How do I cancel/downgrade?

You can initiate a cancellation or downgrade by selecting a new plan and providing at least one reason for your decision. The customer service team will cancel or downgrade your plan. Downgrades are not effective immediately; your premium subscription will remain active until the end of the current billing period.

How do I change between monthly and yearly billing?

To change your subscription from monthly to yearly billing, submit a request on the Contact Us page on the website following these steps:

Step 1: Sign in to your account

Step 2: Go to Contact Us page

Step 3: Fill out the form and choose the “Sales” category for this request.

Step 4: In the text box, include your specific request for example “Change from Monthly to Yearly subscription.”

What is an API Request?

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.

What happens if I exceed my API Request volume?

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. You can learn more about overages billing here.

What is the API's uptime?

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.

There is a public API status page available at the following URL: status.positionstack.com.

What is included in Platinum Support?

Platinum Support includes dedicated account management, priority bug fixes, and access to exclusive support resources. It ensures you receive top-tier assistance for any issues you encounter, helping you maintain and optimize your system performance.

How much does Platinum Support cost?

The cost of Platinum Support varies depending on your subscription plan:
- Standard Plan: $479.88 billed annually
- Professional Plan: $599.88 billed annually
- Professional Plus Plan: $719.88 billed annually
- Enterprise Plan: Custom pricing billed annually

How do I select Platinum Support when purchasing a plan?

When you select a pricing plan, the Platinum Support option is automatically checked. You will see a checkbox next to “Include Platinum Support” with the corresponding annual price. You can uncheck this box if you do not wish to include Platinum Support.

How does Platinum Support appear on my invoice?

When you select Platinum Support, your invoice will display “Selected: [Your Plan] + Platinum Support.” The total amount charged will include the cost of your chosen plan and the annual fee for Platinum Support. For example, if you select the Professional Plan, your invoice will read “$59.99/month + $599.88/year for Platinum Support.”

Can existing customers upgrade to include Platinum Support?

Yes, existing customers can upgrade their plans to include Platinum Support. The option will be automatically checked when viewing available plans, showing the respective annual fee for Platinum Support. You can select or unselect this option as needed.

How is the billing period for Platinum Support handled?

The billing period for Platinum Support is annual. When you purchase Platinum Support, the renewal date will be one year from the purchase date. Your invoice will show the purchase date, renewal date, and the total annual amount for Platinum Support.

Can I opt out of Platinum Support during the purchase process?

Yes, Platinum Support is an optional service, you can uncheck the Platinum Support box during the purchase process if you prefer not to include it.

Can I switch back to standard support after upgrading to Platinum Support?

Yes, you can switch back to standard support at any time. However, the change will take effect at the start of your next billing cycle. Contact our support team to adjust your plan.