OpenStreetMap

OpenStreetMap (OSM) is a collaborative project to create a free, editable map of the world. The OSM ecosystem exposes a family of public REST APIs: the main editing API (v0.6) for CRUD operations on map data, the Overpass API for complex read-only geospatial queries, and the Nominatim API for forward and reverse geocoding. Map data is licensed under the Open Database License (ODbL) 1.0 and tile imagery under CC BY-SA 2.0.

OpenStreetMap publishes 10 APIs on the APIs.io network, including Capabilities API, Changesets API, Map Data API, and 7 more. Tagged areas include Geospatial, Mapping, Open Data, Geocoding, and Editing.

The OpenStreetMap catalog on APIs.io includes 1 JSON-LD context and 1 Spectral governance ruleset.

OpenStreetMap’s developer surface includes authentication, developer portal, documentation, engineering blog, support, and 21 more developer resources.

🌐 Visit website 📡 Source on GitHub

52.9/100 developing ▬ flat Agent 31/100 agent aware Full breakdown ↓
scored 2026-08-20 · rubric v0.12.0

AccessPaidSelf serve

11 APIs 16 Features

Geospatial Mapping Open Data Geocoding Editing

Kin Score

Kin Score How this is scored →
scored 2026-08-20 · rubric v0.12.0

Composite quality — 52.9/100 · developing

Contract Quality 14.5 / 21

Developer Ergonomics 8.5 / 17

Access Clarity 6.3 / 17

Operational Transparency 1.5 / 11

Contract Governance 1.0 / 10

Discoverability 6.3 / 9

Regulatory Posture 11.4 / 15

Agent readiness — 31/100 · agent aware

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

Documented Reversibility 6 / 6

MCP Server 0 / 12

Machine-Readable Auth 10 / 10

Idempotency 0 / 9

Stable Error Semantics 0 / 8

Request/Response Examples 0 / 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

Regulatory Posture applies to this provider. Its tags matched the Government & Public Sector regime, so Regulatory Posture carries 15 points of the composite. If this regime is wrong for your business, say so on your provider repo — the applicability map is public and we will correct it.

The six quality facets above are damped to 85 points between them, because the conditional facet above carries the other 15. That is why each facet's contribution is shown against a damped maximum: raising a quality facet moves the composite by 85% of its nominal weight, not 100%. The full arithmetic is at apis.io/rating/.

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/openstreetmap: 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 11

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

Open Collections 12

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

Rate Limits 1

Documented rate limits and quota policies.

Openstreetmap Rate Limits

4 limits

RATE LIMITS

FinOps 1

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

Openstreetmap Finops

FINOPS

Features 16

Notable capabilities this provider offers.

Free open OSM data under ODbL license

Public API (osm.org) free for personal/educational use

AUP requires self-hosting or 3rd-party for production / heavy use

Tile server: 2 req/sec/IP cap

Nominatim: 1 req/sec/IP cap

Overpass API: 2 concurrent/IP cap

Self-hosting: osm2pgsql + Nominatim + tile renderer (Tilemaker, Mapnik)

Third-party providers: Mapbox, MapTiler, Geoapify, Stadia Maps, TomTom

Editing API for contributing data (free for verified users)

Planet downloads (XML or PBF)

Diff replication (minutely/hourly/daily)

Vector tiles via OpenMapTiles, Shortbread, Versatiles

Funded by OpenStreetMap Foundation (OSMF) donations + corporate sponsors

Data updated continuously by ~10K daily contributors

Foundation policy: https://operations.osmfoundation.org/policies/

Wiki: wiki.openstreetmap.org

Scroll for all 16

JSON Schema 9

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

Scroll for all 9

Scopes 1

OAuth scopes governing access to this provider's APIs.

Openstreetmap Scopes

7 scopes · authorizationCode

7 scopes

SCOPES

Get Started 1

Portal, sign-up, and the first successful call

Portal

Portal

Documentation 6

Reference material describing how the API behaves

Documentation

Reference

Documentation

OpenAPI

OpenAPI

JSONSchema

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess

AgenticAccess

Design & Contract 1

Pagination, idempotency, versioning, errors, and events

JSONLDContext

JSONLDContext

Build 2

SDKs, sample code, and the tooling you integrate with

PostmanWorkspace

PostmanWorkspace

GitHubOrganization

GitHubOrganization

Access & Security 5

Authentication, authorization, and security posture

VulnerabilityDisclosure

VulnerabilityDisclosure

DomainSecurity

Authentication

OAuthScopes

Authentication

Operate 3

Status, limits, changes, and where to get help

RateLimits

RateLimits

Forums

Forums

Support

Support

Commercial 4

Pricing, plans, and the legal terms of use

TermsOfService

PrivacyPolicy

License

License

Company 3

The organization behind the API

LinkedIn

Website

Website

Blog

Blog

Source (apis.yml)

aid: openstreetmap
name: OpenStreetMap
description: 'OpenStreetMap (OSM) is a collaborative project to create a free, editable map of the world. The OSM ecosystem
  exposes a family of public REST APIs: the main editing API (v0.6) for CRUD operations on map data, the Overpass API for
  complex read-only geospatial queries, and the Nominatim API for forward and reverse geocoding. Map data is licensed under
  the Open Database License (ODbL) 1.0 and tile imagery under CC BY-SA 2.0.'
type: Index
accessModel:
  pricing: paid
  onboarding: self-serve
  trial: false
  try_now: false
  public: false
  label: Paid · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
position: Consumer
access: 3rd-Party
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/openstreetmap.png
tags:
- Geospatial
- Mapping
- Open Data
- Geocoding
- Editing
created: '2026-03-18'
modified: '2026-05-19'
url: https://raw.githubusercontent.com/api-evangelist/openstreetmap/refs/heads/main/apis.yml
specificationVersion: '0.23'
apis:
- aid: openstreetmap:overpass-api
  name: OpenStreetMap Overpass API
  description: 'The Overpass API is a read-only database engine for complex geospatial queries against the OSM dataset. Accepts
    Overpass QL or XML queries and returns results in XML, JSON, GeoJSON, or CSV. Safe usage: under 10,000 queries/day and
    under 1 GB/day. Python SDKs include overpass, overpy, and OSMPythonTools; JavaScript SDKs include query-overpass and overpass-ts.'
  humanURL: https://wiki.openstreetmap.org/wiki/Overpass_API
  baseURL: https://overpass-api.de/api
  tags:
  - Geospatial
  - Mapping
  - Open Data
  - XML
  - Overpass
  properties:
  - type: Documentation
    url: https://wiki.openstreetmap.org/wiki/Overpass_API
  - type: Reference
    url: https://dev.overpass-api.de/overpass-doc/en/
  - type: DeveloperTools
    url: https://overpass-turbo.eu/
- aid: openstreetmap:openstreetmap-capabilities-api
  name: OpenStreetMap Capabilities API
  description: API version and limits
  humanURL: https://wiki.openstreetmap.org/wiki/API_v0.6
  baseURL: https://api.openstreetmap.org/api/0.6
  tags:
  - Capabilities
  properties:
  - type: OpenAPI
    url: openapi/openstreetmap-capabilities-api-openapi.yml
  - type: Documentation
    url: https://wiki.openstreetmap.org/wiki/API_v0.6
  - type: RateLimits
    url: https://operations.osmfoundation.org/policies/api/
  - type: JSONSchema
    url: https://raw.githubusercontent.com/api-evangelist/openstreetmap/refs/heads/main/json-schema/openstreetmap-node-schema.json
  - type: JSONLDContext
    url: https://raw.githubusercontent.com/api-evangelist/openstreetmap/refs/heads/main/json-ld/openstreetmap-context.jsonld
  - type: Documentation
    url: https://nominatim.org/release-docs/latest/api/Overview/
  - type: RateLimits
    url: https://operations.osmfoundation.org/policies/nominatim/
- aid: openstreetmap:openstreetmap-changesets-api
  name: OpenStreetMap Changesets API
  description: Changeset management for grouped edits
  humanURL: https://wiki.openstreetmap.org/wiki/API_v0.6
  baseURL: https://api.openstreetmap.org/api/0.6
  tags:
  - Changesets
  properties:
  - type: OpenAPI
    url: openapi/openstreetmap-changesets-api-openapi.yml
  - type: Documentation
    url: https://wiki.openstreetmap.org/wiki/API_v0.6
  - type: RateLimits
    url: https://operations.osmfoundation.org/policies/api/
  - type: JSONSchema
    url: https://raw.githubusercontent.com/api-evangelist/openstreetmap/refs/heads/main/json-schema/openstreetmap-node-schema.json
  - type: JSONLDContext
    url: https://raw.githubusercontent.com/api-evangelist/openstreetmap/refs/heads/main/json-ld/openstreetmap-context.jsonld
  - type: Documentation
    url: https://nominatim.org/release-docs/latest/api/Overview/
  - type: RateLimits
    url: https://operations.osmfoundation.org/policies/nominatim/
- aid: openstreetmap:openstreetmap-map-data-api
  name: OpenStreetMap Map Data API
  description: Bulk map data retrieval by bounding box
  humanURL: https://wiki.openstreetmap.org/wiki/API_v0.6
  baseURL: https://api.openstreetmap.org/api/0.6
  tags:
  - Map Data
  properties:
  - type: OpenAPI
    url: openapi/openstreetmap-map-data-api-openapi.yml
  - type: Documentation
    url: https://wiki.openstreetmap.org/wiki/API_v0.6
  - type: RateLimits
    url: https://operations.osmfoundation.org/policies/api/
  - type: JSONSchema
    url: https://raw.githubusercontent.com/api-evangelist/openstreetmap/refs/heads/main/json-schema/openstreetmap-node-schema.json
  - type: JSONLDContext
    url: https://raw.githubusercontent.com/api-evangelist/openstreetmap/refs/heads/main/json-ld/openstreetmap-context.jsonld
  - type: Documentation
    url: https://nominatim.org/release-docs/latest/api/Overview/
  - type: RateLimits
    url: https://operations.osmfoundation.org/policies/nominatim/
- aid: openstreetmap:openstreetmap-nodes-api
  name: OpenStreetMap Nodes API
  description: OSM node (point) operations
  humanURL: https://wiki.openstreetmap.org/wiki/API_v0.6
  baseURL: https://api.openstreetmap.org/api/0.6
  tags:
  - Nodes
  properties:
  - type: OpenAPI
    url: openapi/openstreetmap-nodes-api-openapi.yml
  - type: Documentation
    url: https://wiki.openstreetmap.org/wiki/API_v0.6
  - type: RateLimits
    url: https://operations.osmfoundation.org/policies/api/
  - type: JSONSchema
    url: https://raw.githubusercontent.com/api-evangelist/openstreetmap/refs/heads/main/json-schema/openstreetmap-node-schema.json
  - type: JSONLDContext
    url: https://raw.githubusercontent.com/api-evangelist/openstreetmap/refs/heads/main/json-ld/openstreetmap-context.jsonld
  - type: Documentation
    url: https://nominatim.org/release-docs/latest/api/Overview/
  - type: RateLimits
    url: https://operations.osmfoundation.org/policies/nominatim/
- aid: openstreetmap:openstreetmap-notes-api
  name: OpenStreetMap Notes API
  description: Community map notes
  humanURL: https://wiki.openstreetmap.org/wiki/API_v0.6
  baseURL: https://api.openstreetmap.org/api/0.6
  tags:
  - Notes
  properties:
  - type: OpenAPI
    url: openapi/openstreetmap-notes-api-openapi.yml
  - type: Documentation
    url: https://wiki.openstreetmap.org/wiki/API_v0.6
  - type: RateLimits
    url: https://operations.osmfoundation.org/policies/api/
  - type: JSONSchema
    url: https://raw.githubusercontent.com/api-evangelist/openstreetmap/refs/heads/main/json-schema/openstreetmap-node-schema.json
  - type: JSONLDContext
    url: https://raw.githubusercontent.com/api-evangelist/openstreetmap/refs/heads/main/json-ld/openstreetmap-context.jsonld
  - type: Documentation
    url: https://nominatim.org/release-docs/latest/api/Overview/
  - type: RateLimits
    url: https://operations.osmfoundation.org/policies/nominatim/
- aid: openstreetmap:openstreetmap-relations-api
  name: OpenStreetMap Relations API
  description: OSM relation operations
  humanURL: https://wiki.openstreetmap.org/wiki/API_v0.6
  baseURL: https://api.openstreetmap.org/api/0.6
  tags:
  - Relations
  properties:
  - type: OpenAPI
    url: openapi/openstreetmap-relations-api-openapi.yml
  - type: Documentation
    url: https://wiki.openstreetmap.org/wiki/API_v0.6
  - type: RateLimits
    url: https://operations.osmfoundation.org/policies/api/
  - type: JSONSchema
    url: https://raw.githubusercontent.com/api-evangelist/openstreetmap/refs/heads/main/json-schema/openstreetmap-node-schema.json
  - type: JSONLDContext
    url: https://raw.githubusercontent.com/api-evangelist/openstreetmap/refs/heads/main/json-ld/openstreetmap-context.jsonld
  - type: Documentation
    url: https://nominatim.org/release-docs/latest/api/Overview/
  - type: RateLimits
    url: https://operations.osmfoundation.org/policies/nominatim/
- aid: openstreetmap:openstreetmap-users-api
  name: OpenStreetMap Users API
  description: User account information
  humanURL: https://wiki.openstreetmap.org/wiki/API_v0.6
  baseURL: https://api.openstreetmap.org/api/0.6
  tags:
  - User
  tags_raw:
  - Users
  properties:
  - type: OpenAPI
    url: openapi/openstreetmap-users-api-openapi.yml
  - type: Documentation
    url: https://wiki.openstreetmap.org/wiki/API_v0.6
  - type: RateLimits
    url: https://operations.osmfoundation.org/policies/api/
  - type: JSONSchema
    url: https://raw.githubusercontent.com/api-evangelist/openstreetmap/refs/heads/main/json-schema/openstreetmap-node-schema.json
  - type: JSONLDContext
    url: https://raw.githubusercontent.com/api-evangelist/openstreetmap/refs/heads/main/json-ld/openstreetmap-context.jsonld
  - type: Documentation
    url: https://nominatim.org/release-docs/latest/api/Overview/
  - type: RateLimits
    url: https://operations.osmfoundation.org/policies/nominatim/
- aid: openstreetmap:openstreetmap-ways-api
  name: OpenStreetMap Ways API
  description: OSM way (line/polygon) operations
  humanURL: https://wiki.openstreetmap.org/wiki/API_v0.6
  baseURL: https://api.openstreetmap.org/api/0.6
  tags:
  - Ways
  properties:
  - type: OpenAPI
    url: openapi/openstreetmap-ways-api-openapi.yml
  - type: Documentation
    url: https://wiki.openstreetmap.org/wiki/API_v0.6
  - type: RateLimits
    url: https://operations.osmfoundation.org/policies/api/
  - type: JSONSchema
    url: https://raw.githubusercontent.com/api-evangelist/openstreetmap/refs/heads/main/json-schema/openstreetmap-node-schema.json
  - type: JSONLDContext
    url: https://raw.githubusercontent.com/api-evangelist/openstreetmap/refs/heads/main/json-ld/openstreetmap-context.jsonld
  - type: Documentation
    url: https://nominatim.org/release-docs/latest/api/Overview/
  - type: RateLimits
    url: https://operations.osmfoundation.org/policies/nominatim/
- aid: openstreetmap:openstreetmap-geocoding-api
  name: OpenStreetMap Geocoding API
  description: Forward geocoding, reverse geocoding, and OSM object lookup
  humanURL: https://wiki.openstreetmap.org/wiki/Overpass_API
  baseURL: https://overpass-api.de/api
  tags:
  - Geocoding
  properties:
  - type: OpenAPI
    url: openapi/openstreetmap-geocoding-api-openapi.yml
- aid: openstreetmap:openstreetmap-status-api
  name: OpenStreetMap Status API
  description: Server status and version information
  humanURL: https://wiki.openstreetmap.org/wiki/Overpass_API
  baseURL: https://overpass-api.de/api
  tags:
  - Status
  properties:
  - type: OpenAPI
    url: openapi/openstreetmap-status-api-openapi.yml
common:
- type: PostmanWorkspace
  url: https://www.postman.com/kinlaneapi/openstreetmap/overview
- type: AgenticAccess
  url: agentic-access/openstreetmap-agentic-access.yml
- type: VulnerabilityDisclosure
  url: security/openstreetmap-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/openstreetmap-domain-security.yml
- type: Authentication
  url: authentication/openstreetmap-authentication.yml
- type: OAuthScopes
  url: scopes/openstreetmap-scopes.yml
- type: LinkedIn
  url: https://www.linkedin.com/company/openstreetmap-foundation
- url: https://www.openstreetmap.org/
  name: OpenStreetMap
  type: Website
- url: https://www.openstreetmap.org/
  name: OSM Map
  type: Portal
- url: https://wiki.openstreetmap.org/wiki/API
  name: API Documentation
  type: Documentation
- url: https://wiki.openstreetmap.org/wiki/API_v0.6
  name: API v0.6 Reference
  type: Reference
- url: https://operations.osmfoundation.org/policies/api/
  name: API Usage Policy and Rate Limits
  type: RateLimits
- url: https://osmfoundation.org/wiki/Terms_of_Use
  name: Terms of Use
  type: TermsOfService
- url: https://osmfoundation.org/wiki/Privacy_Policy
  name: Privacy Policy
  type: PrivacyPolicy
- url: https://blog.openstreetmap.org/
  name: OSM Blog
  type: Blog
- url: https://github.com/openstreetmap
  name: GitHub Organization
  type: GitHubOrganization
- url: https://www.openstreetmap.org/copyright
  name: Copyright and License
  type: License
- url: https://opendatacommons.org/licenses/odbl/
  name: ODbL 1.0 (Map Data)
  type: License
- url: https://wiki.openstreetmap.org/wiki/Main_Page
  name: OSM Wiki
  type: Documentation
- url: https://community.openstreetmap.org/
  name: OSM Community Forum
  type: Forums
- url: https://help.openstreetmap.org/
  name: Help
  type: Support
- url: https://www.openstreetmap.org/copyright
  name: OAuth 2.0 Authentication
  type: Authentication
- url: https://raw.githubusercontent.com/api-evangelist/openstreetmap/refs/heads/main/openapi/openstreetmap-main-openapi.yml
  name: OSM Main API OpenAPI
  type: OpenAPI
- url: https://raw.githubusercontent.com/api-evangelist/openstreetmap/refs/heads/main/openapi/openstreetmap-nominatim-openapi.yml
  name: Nominatim OpenAPI
  type: OpenAPI
- url: https://raw.githubusercontent.com/api-evangelist/openstreetmap/refs/heads/main/json-schema/openstreetmap-node-schema.json
  name: OSM Node JSON Schema
  type: JSONSchema
- url: https://raw.githubusercontent.com/api-evangelist/openstreetmap/refs/heads/main/json-ld/openstreetmap-context.jsonld
  name: OSM JSON-LD Context
  type: JSONLDContext
- type: Features
  data:
  - Free open OSM data under ODbL license
  - Public API (osm.org) free for personal/educational use
  - AUP requires self-hosting or 3rd-party for production / heavy use
  - 'Tile server: 2 req/sec/IP cap'
  - 'Nominatim: 1 req/sec/IP cap'
  - 'Overpass API: 2 concurrent/IP cap'
  - 'Self-hosting: osm2pgsql + Nominatim + tile renderer (Tilemaker, Mapnik)'
  - 'Third-party providers: Mapbox, MapTiler, Geoapify, Stadia Maps, TomTom'
  - Editing API for contributing data (free for verified users)
  - Planet downloads (XML or PBF)
  - Diff replication (minutely/hourly/daily)
  - Vector tiles via OpenMapTiles, Shortbread, Versatiles
  - Funded by OpenStreetMap Foundation (OSMF) donations + corporate sponsors
  - Data updated continuously by ~10K daily contributors
  - 'Foundation policy: https://operations.osmfoundation.org/policies/'
  - 'Wiki: wiki.openstreetmap.org'
  sources:
  - https://www.openstreetmap.org/
  - https://operations.osmfoundation.org/policies/api/
  updated: '2026-05-04'
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com