Pelias website screenshot

Pelias

Pelias is a modular, open-source geocoding search engine built on Elasticsearch that converts addresses and place names into geographic coordinates (forward geocoding) and geographic coordinates into places and addresses (reverse geocoding). Powered entirely by open data from OpenStreetMap, OpenAddresses, Who's on First, and Geonames, it is freely available under the MIT license and can be self-hosted or accessed via hosted services.

Pelias publishes 4 APIs on the APIs.io network, including Autocomplete API, Forward Geocoding API, Place Lookup API, and 1 more. Tagged areas include geocoding, reverse geocoding, geospatial, open source, and elasticsearch.

The Pelias catalog on APIs.io includes 1 Spectral governance ruleset.

Pelias’ developer surface includes documentation, status page, support, and 6 more developer resources.

39.1/100 thin ▬ flat Agent 28/100 agent aware Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessFreemium
4 APIs
geocodingreverse geocodinggeospatialopen sourceelasticsearchopenstreetmapaddressesplacesautocomplete

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 39.1/100 · thin
Contract Quality 13.6 / 25
Developer Ergonomics 2.6 / 20
Commercial Clarity 7.9 / 20
Operational Transparency 0.7 / 13
Governance 7.0 / 12
Discoverability 7.4 / 10
Agent readiness — 28/100 · agent aware
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 0 / 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/pelias: 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 4

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

Pelias Autocomplete API

Real-time type-ahead geocoding for user input

Pelias Forward Geocoding API

Convert text or addresses into geographic coordinates

Pelias Place Lookup API

Retrieve details for a known place by ID

Pelias Reverse Geocoding API

Convert geographic coordinates into places and addresses

Pricing Plans 1

Published pricing tiers and plan structures.

Plans

5 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Rate Limits

0 limits

RATE LIMITS

FinOps 1

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

Finops

FINOPS

Spectral Rules 1

Spectral governance rulesets for linting and validating these APIs.

Pelias API Rules

5 rules · 4 warnings 1 info

SPECTRAL

JSON Schema 1

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

Pelias Geocoding Response

4 properties

JSON SCHEMA

Examples 4

Example request and response payloads for these APIs.

Autocomplete

3 fields

EXAMPLE

Reverse

3 fields

EXAMPLE

Search

3 fields

EXAMPLE

Structured

3 fields

EXAMPLE

Security Posture 1

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

Pelias Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Agentic Access 1

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

Pelias Agentic Access

5 operations

5 operations · 0 acting

AGENTIC

Resources

Documentation 1

Reference material describing how the API behaves

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

Build 1

SDKs, sample code, and the tooling you integrate with

Access & Security 1

Authentication, authorization, and security posture

Operate 2

Status, limits, changes, and where to get help

Commercial 1

Pricing, plans, and the legal terms of use

Company 1

The organization behind the API

Other 1

Properties that don't map to a standard resource type

Source (apis.yml)

apis.yml Raw ↑
name: Pelias
description: Pelias is a modular, open-source geocoding search engine built on Elasticsearch that converts addresses and place
  names into geographic coordinates (forward geocoding) and geographic coordinates into places and addresses (reverse geocoding).
  Powered entirely by open data from OpenStreetMap, OpenAddresses, Who's on First, and Geonames, it is freely available under
  the MIT license and can be self-hosted or accessed via hosted services.
accessModel:
  pricing: freemium
  onboarding: unknown
  trial: false
  try_now: false
  public: false
  label: Freemium
  confidence: medium
  source:
  - plans
  generated: '2026-07-22'
  method: derived
image: https://pelias.io/images/pelias-logo.png
tags:
- geocoding
- reverse geocoding
- geospatial
- open source
- elasticsearch
- openstreetmap
- addresses
- places
- autocomplete
created: '2026-06-13'
modified: '2026-06-13'
url: https://raw.githubusercontent.com/api-evangelist/pelias/main/apis.yml
specificationVersion: '0.19'
apis:
- aid: pelias:pelias-autocomplete-api
  name: Pelias Autocomplete API
  description: Real-time type-ahead geocoding for user input
  humanURL: https://github.com/pelias/documentation
  baseURL: https://api.geocode.earth/v1
  tags:
  - Autocomplete
  properties:
  - type: OpenAPI
    url: openapi/pelias-autocomplete-api-openapi.yml
  - type: Documentation
    url: https://github.com/pelias/documentation
  - type: GitHubOrganization
    url: https://github.com/pelias
  - type: GitHubRepository
    url: https://github.com/pelias/pelias
  - type: Docker
    url: https://github.com/pelias/docker
  - type: Plans
    url: https://raw.githubusercontent.com/api-evangelist/pelias/main/plans/plans.yml
  - type: RateLimits
    url: https://raw.githubusercontent.com/api-evangelist/pelias/main/rate-limits/rate-limits.yml
  - type: FinOps
    url: https://raw.githubusercontent.com/api-evangelist/pelias/main/finops/finops.yml
- aid: pelias:pelias-forward-geocoding-api
  name: Pelias Forward Geocoding API
  description: Convert text or addresses into geographic coordinates
  humanURL: https://github.com/pelias/documentation
  baseURL: https://api.geocode.earth/v1
  tags:
  - Forward Geocoding
  properties:
  - type: OpenAPI
    url: openapi/pelias-forward-geocoding-api-openapi.yml
  - type: Documentation
    url: https://github.com/pelias/documentation
  - type: GitHubOrganization
    url: https://github.com/pelias
  - type: GitHubRepository
    url: https://github.com/pelias/pelias
  - type: Docker
    url: https://github.com/pelias/docker
  - type: Plans
    url: https://raw.githubusercontent.com/api-evangelist/pelias/main/plans/plans.yml
  - type: RateLimits
    url: https://raw.githubusercontent.com/api-evangelist/pelias/main/rate-limits/rate-limits.yml
  - type: FinOps
    url: https://raw.githubusercontent.com/api-evangelist/pelias/main/finops/finops.yml
- aid: pelias:pelias-place-lookup-api
  name: Pelias Place Lookup API
  description: Retrieve details for a known place by ID
  humanURL: https://github.com/pelias/documentation
  baseURL: https://api.geocode.earth/v1
  tags:
  - Place Lookup
  properties:
  - type: OpenAPI
    url: openapi/pelias-place-lookup-api-openapi.yml
  - type: Documentation
    url: https://github.com/pelias/documentation
  - type: GitHubOrganization
    url: https://github.com/pelias
  - type: GitHubRepository
    url: https://github.com/pelias/pelias
  - type: Docker
    url: https://github.com/pelias/docker
  - type: Plans
    url: https://raw.githubusercontent.com/api-evangelist/pelias/main/plans/plans.yml
  - type: RateLimits
    url: https://raw.githubusercontent.com/api-evangelist/pelias/main/rate-limits/rate-limits.yml
  - type: FinOps
    url: https://raw.githubusercontent.com/api-evangelist/pelias/main/finops/finops.yml
- aid: pelias:pelias-reverse-geocoding-api
  name: Pelias Reverse Geocoding API
  description: Convert geographic coordinates into places and addresses
  humanURL: https://github.com/pelias/documentation
  baseURL: https://api.geocode.earth/v1
  tags:
  - Reverse Geocoding
  properties:
  - type: OpenAPI
    url: openapi/pelias-reverse-geocoding-api-openapi.yml
  - type: Documentation
    url: https://github.com/pelias/documentation
  - type: GitHubOrganization
    url: https://github.com/pelias
  - type: GitHubRepository
    url: https://github.com/pelias/pelias
  - type: Docker
    url: https://github.com/pelias/docker
  - type: Plans
    url: https://raw.githubusercontent.com/api-evangelist/pelias/main/plans/plans.yml
  - type: RateLimits
    url: https://raw.githubusercontent.com/api-evangelist/pelias/main/rate-limits/rate-limits.yml
  - type: FinOps
    url: https://raw.githubusercontent.com/api-evangelist/pelias/main/finops/finops.yml
common:
- type: AgenticAccess
  url: agentic-access/pelias-agentic-access.yml
- type: DomainSecurity
  url: security/pelias-domain-security.yml
- type: Website
  url: https://pelias.io
- type: Documentation
  url: https://github.com/pelias/documentation
- type: GitHubOrganization
  url: https://github.com/pelias
- type: License
  url: https://github.com/pelias/pelias/blob/master/LICENSE
- type: HostedService
  url: https://geocode.earth
- type: Status
  url: https://github.com/pelias/pelias/issues
- type: Support
  url: https://gitter.im/pelias/pelias
maintainers:
- FN: Kin Lane
  X-twitter: apievangelist
  email: kin@apievangelist.com