# Shaarli

**Canonical:** https://apis.io/providers/shaarli/  
**Website:** https://demo.shaarli.org  
**APIs profiled:** 2

Shaarli is an open‑source, self‑hosted bookmarking service that lets users store, tag, and share web links. Designed for personal use, it is minimalist, fast, and requires no database, using flat‑file storage instead. The project provides a web interface, a public demo instance, and a REST API for programmatic access. It is written in PHP, released under the MIT license, and can be deployed via Docker or traditional web servers. The community maintains documentation on Read the Docs and offers a client library ecosystem.

## Kin Score — 28.5 / 100 (thin)

Scored 2026-10-31 under rubric 0.25.0.

| Facet | Score |
|---|---|
| Discoverability | 57.1 |
| Contract Quality | 9.4 |
| Contract Governance | 35.6 |
| Operational Transparency | 21.1 |
| Developer Ergonomics | 45.2 |
| Access Clarity | 13.2 |

Regulatory layer — **Horizontal (data, software, accessibility, platform)**: 26.5 (matched via fallback).

## Agent readiness — 20.1 (agent-aware)

| Dimension | Value |
|---|---|
| Spec Presence | yes |
| Agentic Access | no |
| Reversibility Documented | no |
| MCP Server | no |
| Auth Clarity | bearer |
| Idempotency | no |
| Error Semantics | documented |
| OpenAPI Examples | no |
| Rate Limit Signal | no |
| Event Surface Described | no |
| Agent Skills | no |
| Well Known Catalog | no |
| Consent Identity | no |
| Agent Card | no |
| Dry Run Mode | no |
| Delegated Identity | no |
| Protected Resource Metadata | no |
| Dynamic Client Registration | no |
| Agentic Commerce | no |
| Pagination Ratio | na |
| Operation Distinctiveness | distinct |

## APIs (2)

- **Shaarli API** — REST API for the Shaarli bookmarking service.
- **Shaarli API** — Shaarli API as documented publicly: 2 operations. Contract generated from the documentation by API Evangelist (2026-10-28); not the provider's own document.

## Security (2)

- **Shaarli Authentication** — 1 scheme
- **Shaarli Domain Security** — TLSv1.3 · HSTS

## Tags

Bookmarking, Self-hosted, Open-source, PHP, Minimalist

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/providers/shaarli/). Scores are computed from the provider's own public artifacts under a published rubric.