Public API
Read-only access to the published catalog for third-party consumers — integrations, galleries, embeds. All endpoints are JSON, CORS-open, and require an API key.
Authentication
Pass your key as a Bearer token on every request:
curl https://freecsstyles.com/api/v1/designs \ -H "Authorization: Bearer fcs_..."
Keys are issued by the maintainers and shown once at creation — store them somewhere safe. They are stored hashed on our side and can be disabled without deleting history.
Endpoints
/api/v1/designsList published designs. Query params: ?tag=, ?q=, ?limit= (max 50), ?cursor= for keyset pagination.
Returns: { items: Design[], total: number, nextCursor?: string }
/api/v1/designs/{id}One published design including full implementations. Unpublished ids 404 indistinguishably.
Returns: { item: Design }
/api/v1/openapi.jsonThis specification, machine-readable (OpenAPI 3.0).
Returns: OpenAPI document
Limits & errors
- 120 requests/minute per API key →
429when exceeded. 401for missing, invalid, disabled, or out-of-scope keys.- Responses are ETag-cached; send
If-None-Matchfor cheap revalidation.
OpenAPI
Machine-readable spec: /api/v1/openapi.json