positionstack website screenshot

positionstack

Forward and Reverse Batch Geocoding REST API by positionstack (an apilayer product, owned by Idera, Inc.). Convert addresses to coordinates and coordinates to addresses across 2+ billion global places, with optional data modules for country, timezone, sun, and bounding-box enrichment.

positionstack publishes 2 APIs on the APIs.io network: Forward Geocoding API and Reverse Geocoding API. Tagged areas include Geocoding, Reverse Geocoding, Maps, Location, and Address Validation.

The positionstack catalog on APIs.io includes 1 JSON-LD context and 2 Spectral governance rulesets.

positionstack’s developer surface includes authentication, developer portal, signup flow, pricing, documentation, getting-started guide, engineering blog, and 21 more developer resources.

64.2/100 strong ▬ flat Agent 29/100 agent ready Full breakdown ↓
scored 2026-09-08 · rubric v0.20.0
AccessFreemiumSelf serve⚡ Free to try
1 APIs 13 Features 7 Use Cases
GeocodingReverse GeocodingMapsLocationAddress ValidationAPILayerPublic APIs

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-09-08 · rubric v0.20.0
Create-or-Update Ergonomics does not apply to this provider. The published contracts declare no write operations, and a read-only API cannot create-or-update. The facet is excluded from this provider's denominator entirely — not scored zero. A reference or data API is not deficient for being unable to upsert.
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. Every facet and dimension name above is a link: it opens that measurement's own page — what it means, the exact checks that feed it, how the whole catalog distributes on it, and the providers at the top of it. This rating is computed from github.com/api-evangelist/positionstack: open an issue to ask a question, or submit a pull request to add artifacts. Submit an artifact on GitHub — free → Manage your own listing — the Influence plan, $499/mo →

APIs 2

Individual APIs this provider publishes, each with its own machine-readable definition.

positionstack Forward Geocoding API

Convert addresses, place names, or partial location strings into geographic coordinates.

positionstack Reverse Geocoding API

Convert latitude/longitude coordinates into a full address with locality, region, and country.

Postman Collections 1

Ready-to-run Postman collections for exercising this provider's APIs.

positionstack

POSTMAN

Open Collections 5

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

API Collection

OPEN COLLECTION

positionstack

OPEN COLLECTION

Arazzo Workflows 3

Multi-step API workflows described with the Arazzo specification.

positionstack Geocode with Confidence Branch

Forward geocode an address and branch on the match confidence to either enrich or re-verify the result.

ARAZZO

positionstack Geocode Roundtrip

Forward geocode an address, then reverse geocode the resulting coordinates to verify the match.

ARAZZO

positionstack Reverse Geocode Enriched Place Profile

Reverse geocode a coordinate pair with country, timezone, and sun modules to build a full place profile.

ARAZZO

Pricing Plans 1

Published pricing tiers and plan structures.

Rate Limits 1

Documented rate limits and quota policies.

Positionstack Rate Limits

5 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Features 13

Notable capabilities this provider offers.

Forward Geocoding

Convert addresses, place names, and postal codes into geographic coordinates.

Reverse Geocoding

Convert latitude/longitude coordinates into structured address data.

Batch Geocoding

Run up to 80 forward or reverse lookups per request (Professional plan and above).

Multiple Output Formats

Responses available in JSON, XML, and GeoJSON.

Embeddable Maps

Each result includes a `map_url` that can be embedded via iFrame.

Multi-Language Results

Localize results in multiple languages via the `language` parameter.

Country Module

Optional enrichment adding ISO codes, currency, languages, flag, dial code, and area.

Timezone Module

Optional enrichment with IANA timezone, GMT offset, abbreviation, and DST status.

Sun Module

Optional enrichment with sunrise, sunset, and solar transit times.

BBox Module

Optional enrichment with bounding box coordinates per result.

2+ Billion Places

Global coverage across 2+ billion addresses and places.

99.9% Uptime

Average reported availability across forward, reverse, and batch endpoints.

Overage Notifications

Email and dashboard alerts at 75%, 90%, and 100% of monthly quota.

Scroll for all 13

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Positionstack Context

21 classes · 6 properties

JSON-LD

Spectral Rules 2

Spectral governance rulesets for linting and validating these APIs.

positionstack API Rules

5 rules · 4 warnings 1 info

SPECTRAL

positionstack API Rules

8 rules · 3 errors 4 warnings 1 info

SPECTRAL

JSON Schema 2

Standalone JSON Schema definitions for this provider's data models.

ErrorResponse

2 properties

JSON SCHEMA

Location

20 properties

JSON SCHEMA

JSON Structure 1

JSON Structure definitions describing this provider's data shapes.

Positionstack Location Structure

0 properties

JSON STRUCTURE

Examples 4

Example request and response payloads for these APIs.

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Positionstack Authentication

apiKey · 1 scheme

SECURITY

Positionstack Domain Security

TLSv1.3 · DMARC

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Positionstack Agentic Access

2 operations

2 operations · 0 acting

AGENTIC

Use Cases 7

What developers build with this provider.

Address Autocomplete

Power address autocomplete and validation in signup or checkout flows.

Fleet & Asset Tracking

Resolve GPS coordinates from vehicles, IoT devices, or pet trackers into addresses.

Store Locator

Geocode user-entered addresses to find nearest stores or service centers.

Logistics & Delivery

Cleanse and standardize delivery addresses across bulk shipment manifests.

Real Estate Listings

Map property listings by geocoding street addresses.

Market Analysis

Enrich CRM records with geographic, country, and timezone data.

Weather & Local Services

Pair coordinates with weather APIs (e.g. weatherstack) for hyper-local services.

Scroll for all 7

Integrations 5

Pre-built integrations with other platforms and tools.

weatherstack

Sibling apilayer API providing weather data for resolved coordinates.

ipstack

Sibling apilayer API offering IP geolocation that pairs with positionstack lookups.

streetlayer

Sibling apilayer API for address verification and autocomplete.

Mapbox / Leaflet / OpenStreetMap

Display positionstack results on third-party map libraries via the embeddable `map_url`.

Power BI / Tableau / Excel

Bulk-enrich spreadsheet data with coordinates via the batch endpoint.

Solutions 5

Packaged solutions this provider offers.

Free / Hobbyist

100 requests/month, personal use, JSON output, no HTTPS.

Basic

100k req/mo, $9.99/mo, HTTPS, multi-format, commercial license.

Professional

1M req/mo, $49.99/mo, batch endpoint enabled.

Business

3M req/mo, $99.99/mo.

Enterprise / Platinum

Custom volume + SLA + dedicated account team.

Resources

Get Started 3

Portal, sign-up, and the first successful call

Documentation 1

Reference material describing how the API behaves

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

Design & Contract 5

Pagination, idempotency, versioning, errors, and events

Build 3

SDKs, sample code, and the tooling you integrate with

Access & Security 2

Authentication, authorization, and security posture

Operate 5

Status, limits, changes, and where to get help

Commercial 5

Pricing, plans, and the legal terms of use

Company 2

The organization behind the API

Other 1

Properties that don't map to a standard resource type

Source (apis.yml)

apis.yml Raw ↑
aid: positionstack
name: positionstack
description: Forward and Reverse Batch Geocoding REST API by positionstack (an apilayer product, owned by Idera, Inc.). Convert
  addresses to coordinates and coordinates to addresses across 2+ billion global places, with optional data modules for country,
  timezone, sun, and bounding-box enrichment.
url: https://positionstack.com/
deliveryModel:
  model: unknown
  open_source: unknown
  commercial: true
  callable_host: true
  label: Delivery model not determined — needs a product licence on record
  confidence: low
  source:
  - openapi
  - pricing
  - repository-unlicensed
  generated: '2026-08-28'
  method: derived
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: medium
  source:
  - plans
  - authentication
  - security
  generated: '2026-09-03'
  method: derived
image: https://positionstack.com/site_images/positionstack_square.png
specificationVersion: '0.23'
created: '2026-05-28'
modified: '2026-05-29'
x-source: public-apis/public-apis
x-category: Geocoding
x-type: company
x-tier: 3
x-tier-reason: bulk-registered-from-public-apis
tags:
- Geocoding
- Reverse Geocoding
- Maps
- Location
- Address Validation
- APILayer
- Public APIs
tags_raw:
- Geocoding
- Reverse Geocoding
- Maps
- Location
- Address Validation
- apilayer
- Public APIs
apis:
- aid: positionstack:positionstack-forward-geocoding-api
  name: positionstack Forward Geocoding API
  description: Convert addresses, place names, or partial location strings into geographic coordinates.
  humanURL: https://positionstack.com/
  baseURL: https://api.positionstack.com/v1
  tags:
  - Forward Geocoding
  properties:
  - type: OpenAPI
    url: openapi/positionstack-forward-geocoding-api-openapi.yml
  - type: Documentation
    url: https://docs.apilayer.com/positionstack/docs/api-documentation
  - type: APIReference
    url: https://docs.apilayer.com/positionstack/docs/api-documentation
  - type: GettingStarted
    url: https://docs.apilayer.com/positionstack/docs/getting-started
  - type: Authentication
    url: https://docs.apilayer.com/positionstack/docs/api-documentation
  - type: JSONSchema
    url: json-schema/positionstack-location-schema.json
  - type: JSONSchema
    url: json-schema/positionstack-error-schema.json
  - type: JSONStructure
    url: json-structure/positionstack-location-structure.json
  - type: JSONLD
    url: json-ld/positionstack-context.jsonld
  - type: Examples
    url: examples/positionstack-forward-geocode-example.json
  - type: Examples
    url: examples/positionstack-reverse-geocode-example.json
  - type: Examples
    url: examples/positionstack-batch-forward-example.json
  - type: Examples
    url: examples/positionstack-error-example.json
  - type: RateLimits
    url: rate-limits/positionstack-rate-limits.yml
- aid: positionstack:positionstack-reverse-geocoding-api
  name: positionstack Reverse Geocoding API
  description: Convert latitude/longitude coordinates into a full address with locality, region, and country.
  humanURL: https://positionstack.com/
  baseURL: https://api.positionstack.com/v1
  tags:
  - Reverse Geocoding
  properties:
  - type: OpenAPI
    url: openapi/positionstack-reverse-geocoding-api-openapi.yml
  - type: Documentation
    url: https://docs.apilayer.com/positionstack/docs/api-documentation
  - type: APIReference
    url: https://docs.apilayer.com/positionstack/docs/api-documentation
  - type: GettingStarted
    url: https://docs.apilayer.com/positionstack/docs/getting-started
  - type: Authentication
    url: https://docs.apilayer.com/positionstack/docs/api-documentation
  - type: JSONSchema
    url: json-schema/positionstack-location-schema.json
  - type: JSONSchema
    url: json-schema/positionstack-error-schema.json
  - type: JSONStructure
    url: json-structure/positionstack-location-structure.json
  - type: JSONLD
    url: json-ld/positionstack-context.jsonld
  - type: Examples
    url: examples/positionstack-forward-geocode-example.json
  - type: Examples
    url: examples/positionstack-reverse-geocode-example.json
  - type: Examples
    url: examples/positionstack-batch-forward-example.json
  - type: Examples
    url: examples/positionstack-error-example.json
  - type: RateLimits
    url: rate-limits/positionstack-rate-limits.yml
common:
- type: IssueTracker
  url: https://github.com/apilayer/positionstack/issues
- type: AgenticAccess
  url: agentic-access/positionstack-agentic-access.yml
- type: DomainSecurity
  url: security/positionstack-domain-security.yml
- type: Authentication
  url: authentication/positionstack-authentication.yml
- type: PostmanWorkspace
  url: https://www.postman.com/kinlaneapi/positionstack/overview
- type: Arazzo
  url: arazzo/positionstack-geocode-confidence-branch-workflow.yml
  name: positionstack Geocode with Confidence Branch
- type: Arazzo
  url: arazzo/positionstack-geocode-roundtrip-workflow.yml
  name: positionstack Geocode Roundtrip
- type: Arazzo
  url: arazzo/positionstack-reverse-enrich-place-workflow.yml
  name: positionstack Reverse Geocode Enriched Place Profile
- type: Website
  url: https://positionstack.com/
- type: Portal
  url: https://positionstack.com/dashboard
- type: Signup
  url: https://positionstack.com/signup/free
- type: Pricing
  url: https://positionstack.com/product
- type: Documentation
  url: https://docs.apilayer.com/positionstack/docs/api-documentation
- type: GettingStarted
  url: https://docs.apilayer.com/positionstack/docs/getting-started
- type: Blog
  url: https://blog.apilayer.com/
- type: StatusPage
  url: https://positionstack.com/api-status
- type: Support
  url: mailto:support@positionstack.com
- type: FAQ
  url: https://positionstack.com/faq
- type: TermsOfService
  url: https://www.ideracorp.com/legal/APILayer
- type: PrivacyPolicy
  url: https://www.ideracorp.com/Legal/PrivacyPolicy
- type: GitHubOrganization
  url: https://github.com/apilayer
- type: GitHubRepository
  url: https://github.com/apilayer/positionstack
- type: PublicAPIsListing
  url: https://github.com/public-apis/public-apis
- type: Plans
  url: plans/positionstack-plans-pricing.yml
- type: RateLimits
  url: rate-limits/positionstack-rate-limits.yml
- type: FinOps
  url: finops/positionstack-finops.yml
- type: SpectralRules
  url: rules/positionstack-rules.yml
- type: Vocabulary
  url: vocabulary/positionstack-vocabulary.yml
- type: Features
  data:
  - name: Forward Geocoding
    description: Convert addresses, place names, and postal codes into geographic coordinates.
  - name: Reverse Geocoding
    description: Convert latitude/longitude coordinates into structured address data.
  - name: Batch Geocoding
    description: Run up to 80 forward or reverse lookups per request (Professional plan and above).
  - name: Multiple Output Formats
    description: Responses available in JSON, XML, and GeoJSON.
  - name: Embeddable Maps
    description: Each result includes a `map_url` that can be embedded via iFrame.
  - name: Multi-Language Results
    description: Localize results in multiple languages via the `language` parameter.
  - name: Country Module
    description: Optional enrichment adding ISO codes, currency, languages, flag, dial code, and area.
  - name: Timezone Module
    description: Optional enrichment with IANA timezone, GMT offset, abbreviation, and DST status.
  - name: Sun Module
    description: Optional enrichment with sunrise, sunset, and solar transit times.
  - name: BBox Module
    description: Optional enrichment with bounding box coordinates per result.
  - name: 2+ Billion Places
    description: Global coverage across 2+ billion addresses and places.
  - name: 99.9% Uptime
    description: Average reported availability across forward, reverse, and batch endpoints.
  - name: Overage Notifications
    description: Email and dashboard alerts at 75%, 90%, and 100% of monthly quota.
- type: UseCases
  data:
  - name: Address Autocomplete
    description: Power address autocomplete and validation in signup or checkout flows.
  - name: Fleet & Asset Tracking
    description: Resolve GPS coordinates from vehicles, IoT devices, or pet trackers into addresses.
  - name: Store Locator
    description: Geocode user-entered addresses to find nearest stores or service centers.
  - name: Logistics & Delivery
    description: Cleanse and standardize delivery addresses across bulk shipment manifests.
  - name: Real Estate Listings
    description: Map property listings by geocoding street addresses.
  - name: Market Analysis
    description: Enrich CRM records with geographic, country, and timezone data.
  - name: Weather & Local Services
    description: Pair coordinates with weather APIs (e.g. weatherstack) for hyper-local services.
- type: Integrations
  data:
  - name: weatherstack
    description: Sibling apilayer API providing weather data for resolved coordinates.
  - name: ipstack
    description: Sibling apilayer API offering IP geolocation that pairs with positionstack lookups.
  - name: streetlayer
    description: Sibling apilayer API for address verification and autocomplete.
  - name: Mapbox / Leaflet / OpenStreetMap
    description: Display positionstack results on third-party map libraries via the embeddable `map_url`.
  - name: Power BI / Tableau / Excel
    description: Bulk-enrich spreadsheet data with coordinates via the batch endpoint.
- type: Solutions
  data:
  - name: Free / Hobbyist
    description: 100 requests/month, personal use, JSON output, no HTTPS.
  - name: Basic
    description: 100k req/mo, $9.99/mo, HTTPS, multi-format, commercial license.
  - name: Professional
    description: 1M req/mo, $49.99/mo, batch endpoint enabled.
  - name: Business
    description: 3M req/mo, $99.99/mo.
  - name: Enterprise / Platinum
    description: Custom volume + SLA + dedicated account team.
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com

Work with this as data

Every provider here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for providers

9 MCP tools reach this
  • find_providersBrowse and filter every provider in the catalog.
  • get_provider_artifactsEvery artifact this provider publishes, grouped by type.
  • get_provider_operationsEvery operation across all of their OpenAPIs — one call instead of parsing every spec.
  • get_provider_toolsEvery MCP tool they ship, with the operation each wraps.
  • get_provider_evidenceHow each part of their score was established. Free — the basis for a claim should not sit behind it.
  • get_provider_ratingPRO — composite, band, trend and facet scores.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This provider
curl "https://apis.io/api/v1/providers/positionstack"
All providers
curl "https://apis.io/api/v1/providers?limit=25"
Every operation they expose
curl "https://apis.io/api/v1/providers/positionstack/operations?limit=25"
How their score was established
curl "https://apis.io/api/v1/providers/positionstack/evidence"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.