Skip to content

Creators

Creators are users who have published at least one model on Civitai.

List creators

GET /api/v1/creators

Auth: Public.

Query parameters

NameTypeDefaultDescription
limitinteger (1–200)20Number of items per page.
pageinteger (≥ 1)11-indexed page number.
querystringFull-text search on username.

Pagination is page-based only — there is no cursor parameter on this endpoint.

Response

json
{
  "items": [
    {
      "username": "JustMaier",
      "modelCount": 3,
      "link": "https://civitai.com/api/v1/models?username=JustMaier",
      "image": "https://image.civitai.com/.../JustMaier.jpeg"
    }
  ],
  "metadata": {
    "totalItems": 84916,
    "currentPage": 1,
    "pageSize": 1,
    "totalPages": 84916,
    "nextPage": "https://civitai.com/api/v1/creators?limit=1&page=2"
  }
}

Field notes

  • link is pre-built — follow it to list a creator's models via GET /models.
  • modelCount is only included when greater than zero; creators with no published models are excluded from the listing entirely.
  • image is null when the creator has no avatar.

Notes

  • page * limit > 1000 returns 429. Beyond the first few thousand creators you'll need to scope the query (e.g. with ?query=) rather than paging linearly.

Examples

bash
# First page
curl "https://civitai.com/api/v1/creators?limit=20"

# Find a specific creator
curl "https://civitai.com/api/v1/creators?query=JustMaier"
GET

Civitai Developer Documentation