Public API · v1
Lyra's curated lists, openly served.
Lyra publishes its block list, clean list and version metadata as public JSON files. The browser extension reads them every 6 hours to stay in sync. You can read them too — for auditing, integration, or building your own tool on top.
Served from Cloudflare's global CDN. No authentication, no rate limits beyond Cloudflare's standard protections. Updated by the Lyra curation team and (optionally) community contributions.
Endpoints
GET /v1/version.json
Current version numbers and counts for both lists. The extension fetches this first; if the version matches what it has cached locally, it skips downloading the full lists.
/v1/version.json →GET /v1/domains.json
The full curated block list. Fast-fashion, dropshipping, and predatory marketplace domains the Lyra team and community have flagged. Each entry has a domain, category, and date added.
/v1/domains.json →GET /v1/clean.json
The curated Clean list — brands the Lyra community uses and trusts. Slow buy, sustainable, quality. Each entry has a domain, brand name, category and (optional) country.
/v1/clean.json →Authentication-required endpoints
Personal lists and account management live under /api/v1/ and require a logged-in Lyra session cookie. See the OpenAPI spec for full reference.
Terms
The lists are licensed permissively — feel free to use them in your own tools, attributed back to Lyra. The lists are updated regularly; if you mirror, consider re-fetching every 24 hours so you don't ship stale data.
Questions, integrations, contributions: [email protected].