# PinSharing

> Map API built on OpenStreetMap data: static map images (including a privacy area mode that shows roughly where a place is without revealing the address), geocoding and reverse geocoding, and raster and vector tiles. Paid plans may store results indefinitely; every plan has a hard monthly cap and nothing is billed for overage.

- API base: https://api.pinsharing.com — authenticate with `?key=ps_…` or `Authorization: Bearer ps_…`
- Free keys (no card): https://pinsharing.com/dashboard
- Attribution "© OpenStreetMap contributors" is required wherever results or maps are shown.

## Docs
- [API reference](https://pinsharing.com/docs.md): all endpoints, parameters, errors and limits
- [Leaflet quickstart](https://pinsharing.com/docs/leaflet.md): raster tiles and address search in Leaflet
- [MapLibre GL JS quickstart](https://pinsharing.com/docs/maplibre.md): vector tiles and styles
- [OpenLayers quickstart](https://pinsharing.com/docs/openlayers.md): raster and vector tiles in OpenLayers
- [AI assistants (MCP)](https://pinsharing.com/docs/mcp.md): connect Claude, Cursor, VS Code and other MCP clients
- [OpenAPI 3.1 spec](https://pinsharing.com/openapi.json): machine-readable API description

## Product
- [Pricing](https://pinsharing.com/pricing.md): plans, caps and what counts
- [Privacy area maps](https://pinsharing.com/privacy-maps.md): listing maps that hide the exact address
- [Compare](https://pinsharing.com/compare.md): storage rights and overage terms vs other map APIs
- [About](https://pinsharing.com/about.md)

## Optional
- [Terms](https://pinsharing.com/terms.md)
- [Privacy policy](https://pinsharing.com/privacy.md)
- [Full docs in one file](https://pinsharing.com/llms-full.txt)