Skip to content

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

GET/api/v1/designs

List published designs. Query params: ?tag=, ?q=, ?limit= (max 50), ?cursor= for keyset pagination.

Returns: { items: Design[], total: number, nextCursor?: string }

GET/api/v1/designs/{id}

One published design including full implementations. Unpublished ids 404 indistinguishably.

Returns: { item: Design }

GET/api/v1/openapi.json

This specification, machine-readable (OpenAPI 3.0).

Returns: OpenAPI document

Limits & errors

  • 120 requests/minute per API key → 429 when exceeded.
  • 401 for missing, invalid, disabled, or out-of-scope keys.
  • Responses are ETag-cached; send If-None-Match for cheap revalidation.

OpenAPI

Machine-readable spec: /api/v1/openapi.json