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 3 APIs on the APIs.io network: Batch Geocoding API, 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 20 more developer resources.

🌐 Visit website 📡 Source on GitHub

63.1/100 strong ▬ flat Agent 37/100 agent ready Full breakdown ↓
scored 2026-07-28 · rubric v0.6

AccessFreemiumSelf serve⚡ Free to try

3 APIs 13 Features 7 Use Cases

GeocodingReverse GeocodingMapsLocationAddress ValidationapilayerPublic APIs

Kin Score

Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6

Composite quality — 63.1/100 · strong

Contract Quality 19.7 / 25

Developer Ergonomics 10.0 / 20

Commercial Clarity 14.2 / 20

Operational Transparency 2.7 / 13

Governance 8.3 / 12

Discoverability 8.2 / 10

Agent readiness — 37/100 · agent ready

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

MCP Server 0 / 12

Machine-Readable Auth 10 / 10

Idempotency 0 / 9

Stable Error Semantics 0 / 8

Request/Response Examples 7 / 7

Rate-Limit Signaling 7 / 7

Typed Event Surface 0 / 6

Agent Skills 0 / 5

Well-Known Catalog 0 / 4

Consent & Bot Identity 0 / 3

A2A Agent Card 0 / 8

Dry-Run / Simulate Mode 0 / 4

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. 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. Want it done for you? Prioritized profiling — $2,500 →

APIs 3

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

Rate Limits 1

Documented rate limits and quota policies.

Positionstack Rate Limits

0 limits

RATE LIMITS

FinOps 1

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

Positionstack Finops

FINOPS

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

JSON Schema 2

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

Examples 4

Example request and response payloads for these APIs.

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

Portal

Portal

Signup

Signup

GettingStarted

GettingStarted

Documentation 1

Reference material describing how the API behaves

Documentation

Documentation

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess

AgenticAccess

Design & Contract 5

Pagination, idempotency, versioning, errors, and events

Arazzo

Arazzo

Arazzo

SpectralRules

Vocabulary

Build 3

SDKs, sample code, and the tooling you integrate with

PostmanWorkspace

PostmanWorkspace

GitHubOrganization

GitHubOrganization

GitHubRepository

GitHubRepository

Access & Security 2

Authentication, authorization, and security posture

DomainSecurity

DomainSecurity

Authentication

Authentication

Operate 4

Status, limits, changes, and where to get help

StatusPage

Support

FAQ

RateLimits

Commercial 5

Pricing, plans, and the legal terms of use

Pricing

TermsOfService

PrivacyPolicy

Plans

FinOps

Company 2

The organization behind the API

Website

Website

Blog

Blog

Other 1

Properties that don't map to a standard resource type

PublicAPIsListing

PublicAPIsListing

Source (apis.yml)

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/
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://positionstack.com/site_images/positionstack_square.png
specificationVersion: '0.20'
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
apis:
- aid: positionstack:positionstack-batch-geocoding-api
  name: positionstack Batch Geocoding API
  description: Run multiple forward or reverse geocoding lookups in a single request (Professional plan and above).
  humanURL: https://positionstack.com/
  baseURL: https://api.positionstack.com/v1
  tags:
  - Batch Geocoding
  properties:
  - type: OpenAPI
    url: openapi/positionstack-batch-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-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: 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

positionstack

APIs 3

Postman Collections 1

Open Collections 1

Arazzo Workflows 3

Pricing Plans 1

Rate Limits 1

FinOps 1

Features 13

Forward Geocoding

Reverse Geocoding

Batch Geocoding

Multiple Output Formats

Embeddable Maps

Multi-Language Results

Country Module

Timezone Module

Sun Module

BBox Module

2+ Billion Places

99.9% Uptime

Overage Notifications

Semantic Vocabularies 1

Spectral Rules 2

JSON Schema 2

JSON Structure 1

Examples 4

Security Posture 2

Agentic Access 1

Use Cases 7

Address Autocomplete

Fleet & Asset Tracking

Store Locator

Logistics & Delivery

Real Estate Listings

Market Analysis

Weather & Local Services

Integrations 5

weatherstack

ipstack

streetlayer

Mapbox / Leaflet / OpenStreetMap

Power BI / Tableau / Excel

Solutions 5

Free / Hobbyist

Basic

Professional

Business

Enterprise / Platinum

Get Started 3

Documentation 1

Agent Surfaces 1

Design & Contract 5

Build 3

Access & Security 2

Operate 4

Commercial 5

Company 2

Other 1

Source (apis.yml)