> ## 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.

# API Pública Ghosting: consulte perfis, badges e criadores

> API REST pública e gratuita da plataforma Ghosting. Consulte perfis, avatares, decorações, selos de verificação e criadores sem autenticação.

A API pública do **Ghosting** (`ghosting.fun`) permite que desenvolvedores, bots de Discord, extensões e plataformas parceiras consultem dados públicos de perfis cadastrados na plataforma. Todas as rotas são REST, retornam JSON e não exigem API key.

<CardGroup cols={2}>
  <Card title="Primeiros Passos" icon="rocket" href="/primeiros-passos">
    Faça sua primeira requisição em menos de um minuto.
  </Card>

  <Card title="Referência de API" icon="code" href="/api-reference/get-user">
    Explore os endpoints, parâmetros e respostas.
  </Card>

  <Card title="Schemas" icon="layers" href="/schemas/user">
    Entenda a estrutura dos objetos retornados.
  </Card>

  <Card title="Bot Discord" icon="bot" href="/guias/bot-discord">
    Integre o Ghosting em um comando slash com Discord.js v14.
  </Card>
</CardGroup>

## O que você pode fazer

* Obter fotos de perfil e decorações dinâmicas de avatar (animadas ou estáticas).
* Consultar selos de verificação, status de moderação e motivos de suspensão.
* Ler biografias, links sociais e contadores de visualizações da página.
* Verificar a existência de domínio personalizado atrelado a um usuário.
* Listar criadores ativos em tempo real.

## Características

<CardGroup cols={2}>
  <Card title="Sem autenticação" icon="lock-open">
    100% pública e gratuita. Não requer API key, JWT ou tokens.
  </Card>

  <Card title="CORS aberto" icon="globe">
    Consuma direto do navegador de qualquer domínio.
  </Card>

  <Card title="Cache CDN" icon="bolt">
    Respostas com cache de 30s no edge e revalidação de 60s.
  </Card>

  <Card title="Design tolerante a falhas" icon="shield">
    Perfis suspensos retornam 200 OK para não quebrar bots.
  </Card>
</CardGroup>

## Base URL

Todas as requisições usam HTTPS:

```http theme={null}
https://ghosting.fun
```

## Próximos passos

<CardGroup cols={2}>
  <Card title="Consultar um perfil" icon="user" href="/api-reference/get-user">
    `GET /api/v1/users/:username`
  </Card>

  <Card title="Listar criadores" icon="users" href="/api-reference/list-creators">
    `GET /ghosting-api/v1/creators`
  </Card>
</CardGroup>