positionstack

Overview

positionstack is an API service specializing in forward and reverse geocoding, providing a programmatic interface for converting location data. The API allows developers to transform textual addresses, such as "1600 Amphitheatre Parkway, Mountain View, CA", into precise latitude and longitude coordinates (forward geocoding). Conversely, it can convert a given set of coordinates, like 34.052235, -118.243683, into a structured address format (reverse geocoding).

The service is designed for developers who need to integrate location functionality into web and mobile applications without managing extensive geographical datasets or complex infrastructure. Common use cases include auto-completing address forms, mapping user-provided locations, displaying nearby points of interest, or enriching datasets with geographical information. For instance, an e-commerce platform might use positionstack to validate shipping addresses or calculate delivery zones.

positionstack offers a RESTful architecture, making it accessible from various programming environments. It provides clear documentation with code examples in multiple languages, including cURL, PHP, Python, and JavaScript, to facilitate integration. The API handles various address formats and aims to return structured results, including street number, street name, city, state, country, and postal code, along with bounding box information for the geocoded location. The service is suitable for small to medium-sized applications that require reliable geocoding capabilities without the need for advanced features such as routing, advanced map rendering, or real-time traffic data.

The API is offered with a free tier, allowing up to 10,000 requests per month, which supports initial development and testing phases. Paid plans scale up to 2.5 million requests monthly, catering to growing application demands. This tiered approach makes it a viable option for projects ranging from personal tools to commercial applications with moderate usage requirements.

Key features

• Forward Geocoding: Converts human-readable addresses (e.g., "New York City" or "Eiffel Tower, Paris") into precise latitude and longitude coordinates. This feature supports various query formats, including full addresses, city names, or points of interest, and returns structured address components.
• Reverse Geocoding: Transforms geographical coordinates (latitude and longitude) back into human-readable addresses and associated metadata. This is useful for displaying location names based on GPS data or map clicks.
• Structured JSON Responses: All API responses are delivered in JSON format, providing structured data including country, region, city, street, postal code, and confidence scores for geocoded results.
• Rate Limiting & Scalability: The service implements rate limiting based on subscription tiers, allowing applications to scale from a free tier of 10,000 requests per month up to 2.5 million requests on enterprise plans.
• HTTPS Encryption: All API requests are secured using HTTPS, protecting data in transit between the client application and the positionstack servers.
• Developer-Friendly Documentation: Comprehensive documentation includes API endpoint details, request parameters, response structures, and code examples across multiple programming languages to simplify integration, as detailed in the positionstack API reference.

Pricing

positionstack offers a tiered pricing model, including a free plan and several paid subscriptions that scale with request volume. All plans include access to both forward and reverse geocoding APIs and secure HTTPS encryption.

Pricing accurate as of May 2026. For the most current pricing details, refer to the official positionstack pricing page.

Common integrations

positionstack's geocoding capabilities can be integrated into various applications and workflows. While specific pre-built integrations are not extensively marketed, its RESTful API design allows for custom integration with:

• Web Applications: Integrate into front-end (e.g., JavaScript frameworks) or back-end (e.g., Node.js, Python, PHP) web applications to power address auto-completion, location search, or map rendering.
• Mobile Applications: Use in iOS or Android apps to convert GPS coordinates to human-readable addresses or to geocode user-input locations.
• CRM and ERP Systems: Enrich customer or business partner records with accurate geographical data for logistics, sales territory management, or data analysis.
• Business Intelligence Tools: Incorporate geocoded data into BI dashboards to visualize geographical trends, customer distribution, or operational hotspots.
• Data Processing & ETL Workflows: Automate the geocoding of large datasets during extract, transform, load (ETL) processes to standardize location information.
• Content Management Systems (CMS): Add location tagging to articles, events, or listings within platforms like WordPress or Drupal.

Alternatives

• Google Maps Platform Geocoding API: Offers comprehensive geocoding, reverse geocoding, and place search with extensive global coverage and integration with other Google Maps services. It provides additional features like viewport biasing and component filtering.
• OpenCage Geocoding API: A global geocoding API built on open data sources, providing forward and reverse geocoding with detailed address components and language support. OpenCage emphasizes data privacy and transparent sourcing, as noted in their developer API documentation.
• Mapbox Geocoding API: Provides forward and reverse geocoding with a focus on customization and integration with Mapbox's mapping and navigation solutions. It supports custom datasets and offers robust search capabilities.
• Esri ArcGIS Geocoding Service: Offers advanced geocoding capabilities for enterprise GIS applications, including batch geocoding, address standardization, and integration with the ArcGIS platform for spatial analysis.

Getting started

To begin using positionstack, you first need to obtain an API access key from your account dashboard after signing up on their website. Once you have the key, you can make HTTP GET requests to the API endpoints. The primary endpoints are for forward geocoding (converting address to coordinates) and reverse geocoding (converting coordinates to address).

Here's a basic example using cURL to perform a forward geocoding request for "Eiffel Tower":

curl 'http://api.positionstack.com/v1/forward
    ?access_key=YOUR_ACCESS_KEY
    &query=Eiffel Tower'

Replace YOUR_ACCESS_KEY with your actual API key. The API will return a JSON object containing location data. A successful response for the Eiffel Tower query might look like this (abbreviated):

{
  "data": [
    {
      "latitude": 48.8582602,
      "longitude": 2.294499,
      "label": "Eiffel Tower, Champ de Mars, Paris, France",
      "name": "Eiffel Tower",
      "continent": "Europe",
      "country": "France",
      "country_code": "FR",
      "region": "Île-de-France",
      "region_code": "IDF",
      "county": "Paris",
      "city": "Paris",
      "street": "Champ de Mars",
      "postal_code": "75007",
      "confidence": 1,
      "type": "venue"
    }
  ]
}

For reverse geocoding, you would use the /reverse endpoint with latitude and longitude parameters. For instance, to get the address for coordinates near the Eiffel Tower:

curl 'http://api.positionstack.com/v1/reverse
    ?access_key=YOUR_ACCESS_KEY
    &query=48.8582602,2.294499'

This request would return structured address data for the specified coordinates. Detailed parameter options, such as language preferences or result limits, are available in the positionstack API documentation.