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 8 APIs on the APIs.io network, including Capabilities API, Changesets API, Map Data API, and 5 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

61.6/100 strong ▬ flat Agent 31/100 agent aware Full breakdown ↓
scored 2026-07-28 · rubric v0.6

AccessPaidSelf serve

9 APIs 16 Features

GeospatialMappingOpen DataGeocodingEditing

Kin Score

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

Composite quality — 61.6/100 · strong

Contract Quality 18.7 / 25

Developer Ergonomics 9.1 / 20

Commercial Clarity 12.1 / 20

Operational Transparency 4.8 / 13

Governance 7.0 / 12

Discoverability 7.4 / 10

Agent readiness — 31/100 · agent aware

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 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

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 9

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

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.19'
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:
  - 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/
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

OpenStreetMap

APIs 9

Postman Collections 8

Open Collections 1

Pricing Plans 1