Reference & policies .md

Our commitments

Developers building on someone else's platform are extending trust. These are the terms of that trust, in writing, on a page we intend to keep pointing at for years.

No connection caps, ever#

A free FlickList account can connect as many third-party apps as its owner wants. We will not cap connected apps, and we will not move existing connectivity behind a paid tier. If you build something people love, every FlickList user can run it.

Unlimited lists, forever#

Lists are core to how people use FlickList, not a premium lever. There is no list count limit for users, and none for lists your app creates on their behalf.

Additive-only stability#

/v3 only ever gains. Fields are added, never removed or renamed; shipped endpoint behavior does not change. Anything breaking would ship as a future /v4 alongside, not on top of, what your app already uses. Write your client to ignore unknown fields and it will keep working.

Familiar shapes, on purpose#

The catalog responds like TMDB and the sync surface is shaped like Trakt's API, so the client code, mental models, and libraries you already have carry over. Compatibility with your existing work is a feature we maintain, not an accident.

Honest data credit#

Catalog data combines TMDB (primary), IMDb (ratings backup), and TVDB and AniList where we hold the cross-links. Sources get credited, and your app should pass that credit through where it displays the data.

Published limits, no surprises#

The rate limit is published, generous for real apps, and enforced with an honest 429 plus Retry-After. If your project needs more headroom, ask; we would rather raise a limit than watch you engineer around it.