---
url: /site.md
description: 'REST API for browsing models, images, creators, and tags on civitai.com.'
---

> Documentation index: https://developer.civitai.com/llms.txt — every page on this site has a markdown version at its URL + `.md`.

# Civitai Site API

The Civitai site exposes a public REST API at `https://civitai.com/api/v1/...` for
browsing models, model versions, images, creators, and tags. It's the same
surface that powers third-party tools like Stable Diffusion downloaders and
metadata lookup utilities.

This is **not** the Orchestration API. If you are building a service that
submits generation work against your own orchestrator credentials, see the
[Orchestration docs](https://developer.civitai.com/orchestration.md).

The one exception is the **`civitai` CLI**, which lives in this section. As well
as reading these endpoints it can run a generation on your own account and spend
your own Buzz — see [Generating images from the CLI](https://developer.civitai.com/site/guide/cli-generate.md). That
is a terminal tool for a civitai.com user, not the partner orchestrator API.

## Where to start

* **[Guide](https://developer.civitai.com/site/guide.md)** — authentication, pagination, error handling, and the
  AIR (AI Resource Identifier) format.
* **[Reference](https://developer.civitai.com/site/reference.md)** — per-resource documentation for every public
  endpoint (models, images, articles, collections, creators, tags, users).
* **[CLI](https://developer.civitai.com/site/guide/cli.md)** — search, fetch and download from the terminal with
  the `civitai` CLI. Also the home of the CLI's
  [credentials](https://developer.civitai.com/site/guide/cli-auth.md) and
  [generation](https://developer.civitai.com/site/guide/cli-generate.md) pages.

## Quick example

```bash
# Public — no auth required
curl "https://civitai.com/api/v1/models?limit=1&types=LORA"

# Authenticated — pass a Civitai API token
curl -H "Authorization: Bearer $CIVITAI_TOKEN" \
  "https://civitai.com/api/v1/me"
```

See [Getting started](https://developer.civitai.com/site/guide/getting-started.md) for a full walkthrough.