> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ghosting.fun/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /ghosting-api/v1/creators · Listar criadores

> Recupere a lista de criadores ativos na plataforma Ghosting. Perfis deletados, inativos ou banidos são filtrados automaticamente. Cache CDN de 30 segundos.

Este endpoint retorna todos os criadores atualmente ativos na plataforma Ghosting. A resposta é um array de perfis completos, excluindo automaticamente contas deletadas, inativas ou banidas. O resultado é cacheado por 30 segundos no CDN, então atualizações podem levar esse tempo para refletir.

## URL

```text theme={null}
GET https://ghosting.fun/ghosting-api/v1/creators
```

## Parâmetros

Este endpoint não aceita parâmetros de query. O filtro de criadores ativos é aplicado automaticamente pelo servidor.

## Headers de resposta

| Header                         | Valor                                            |
| ------------------------------ | ------------------------------------------------ |
| `Content-Type`                 | `application/json; charset=utf-8`                |
| `Access-Control-Allow-Origin`  | `*`                                              |
| `Access-Control-Allow-Methods` | `GET, OPTIONS`                                   |
| `Cache-Control`                | `public, s-maxage=30, stale-while-revalidate=60` |

## Exemplos de requisição

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://ghosting.fun/ghosting-api/v1/creators" \
    -H "Accept: application/json"
  ```

  ```js JavaScript (fetch) theme={null}
  const response = await fetch("https://ghosting.fun/ghosting-api/v1/creators");
  const data = await response.json();
  console.log(data);
  ```

  ```py Python (requests) theme={null}
  import requests

  response = requests.get("https://ghosting.fun/ghosting-api/v1/creators")
  data = response.json()
  print(data)
  ```
</CodeGroup>

## Exemplo de resposta (200 OK)

```json theme={null}
{
  "success": true,
  "data": [
    {
      "username": "ghosting",
      "displayName": "Ghosting Oficial",
      "bio": "Desenvolvedor & Criador de Conteúdo. Criando experiências digitais no Ghosting.",
      "avatarUrl": "https://ghosting.fun/api/avatar?u=ghosting",
      "pageUrl": "https://ghosting.fun/p/ghosting",
      "hasCustomDomain": false,
      "customDomain": null,
      "accountAgeDays": 140,
      "createdAt": "2026-04-15T12:00:00.000Z",
      "views": 32890,
      "badges": {
        "isVerified": true,
        "isOfficial": true,
        "isHelper": true,
        "list": ["official", "verified", "helper"]
      },
      "avatarDecoration": {
        "id": "spirit_embers",
        "name": "Spirit Embers",
        "file": "spirit_embers.png",
        "url": "https://ghosting.fun/api/decoration?f=spirit_embers.png"
      },
      "socials": [
        { "platform": "discord", "url": "https://discord.gg/vkWVxrd9Bn" },
        { "platform": "github", "url": "https://github.com/ihyos/PAYLINK" },
        { "platform": "steam", "url": "https://steamcommunity.com/id/ghosting" }
      ],
      "status": "active",
      "banInfo": {
        "isBanned": false,
        "message": null,
        "reason": null,
        "bannedAt": null
      }
    }
  ],
  "meta": {
    "timestamp": "2026-09-06T18:00:00.000Z",
    "version": "v1",
    "executionTimeMs": 6
  }
}
```

<Info>
  O campo `data` é um array de objetos `User`. Cada item segue a mesma estrutura documentada em [User](/schemas/user).
</Info>