Skip to content

0010 hosted api

github-actions[bot] edited this page Nov 18, 2026 · 1 revision

A hosted API with a free tier is the paid product

Status: accepted · Implementation: planned · Date: 2026-11-18

From LibreLifts ADR 0016. Hosting, billing, the legal entity, the terms of service and the trademark policy get their own records. Prices are not decided here.

Context

Everything in the app is free (0006), and the project runs a server for accounts and backup (0014). Servers cost money. The open database (0008) is useful to other apps, and serving it reliably is worth paying for.

The data is open and its dumps are free (0009), so the data itself cannot be what is sold. MetaBrainz earns its income this way: the data is free, and companies pay for a current feed, support and not having to run the pipeline themselves.

Decision

  • The project sells a hosted API to the database. The app stays free.
  • The paid API serves reference data only. It has no endpoints for personal data.
  • What is paid for is the service, never the data: higher rate limits, fresher data than the dumps, delivery of media, an uptime commitment and support.
  • There is a free tier. It needs a key, is rate-limited and requires attribution.
  • Commercial use of the hosted API needs a paid tier. Commercial use of the data does not: the dumps are free to anyone.
  • The terms forbid free-riding: reselling or proxying the API, and copying the whole database through it instead of the dumps. A key can be revoked.
  • The name and logo are not licensed by Apache-2.0 or ODbL. A fork or a reuser must not suggest it is LibreBars or is endorsed by it.
  • The app does not depend on the paid API. It works without it.

Consequences

  • Income is likely to be small and slow until other products depend on the data.
  • The project will take payments, which needs terms and a legal entity.
  • "Everything is free" has to be said precisely: everything in the app is free, and the data is free. The service is what costs.
  • Free tiers of public APIs are scraped heavily. Keys, limits per key and free dumps are the defence, and the dumps make the limits fair.
  • The same service that serves the paid API also serves the project's own apps, and the two parts have to stay visibly apart (0015).

LibreBars

Clone this wiki locally