API

API pública de Obsidian Profile

Consulta perfiles, widgets y contenido de forma programática.

Base URL

https://api.obsi.bio/api/v1

Los endpoints públicos no requieren autenticación. Los que marcan "requiere auth" usan un Bearer token de JWT obtenido al iniciar sesión.

Endpoints públicos

GET/profiles/:usernameObtiene un perfil público por username.

GET/profiles/trendingLista perfiles con más vistas de la semana.

GET/profiles/featuredLista perfiles destacados y verificados.

GET/profiles/discoverExplora perfiles recientes (paginado).

GET/decorationsLista decoraciones de avatar (requiere auth).

GET/framesLista marcos de perfil (requiere auth).

GET/widgets/typesLista los tipos de widget disponibles.

GET/social/linksEnlaces sociales del usuario (requiere auth).

Ejemplo

Obtener un perfil

GET https://api.obsi.bio/api/v1/profiles/usuario

{
  "id": "clx...",
  "username": "usuario",
  "displayName": "Usuario",
  "avatar": "https://...",
  "bio": "Hola!",
  "customization": { ... },
  "widgets": [ ... ]
}

Rate limits

Endpoints públicos: 60 peticiones/minuto por IP.
Endpoints con auth: 120 peticiones/minuto por usuario.
Los límites aplican por IP y por cuenta.