Documentación API

Visión General

La API de Italian Brainrot Wiki proporciona acceso programático a nuestra base de datos de personajes. Todos los endpoints devuelven datos JSON y soportan CORS para aplicaciones basadas en navegador.

URL Base: https://italianbrainrot.wiki/api

Endpoints

GET /api/characters

Recuperar una lista paginada de personajes

Parámetros de Consulta:

page - Page number (default: 1)
limit - Items per page (default: 20, max: 100)
sort - Sort by: popularity, name, recent (default: popularity)
type - Filter by character type
order - Sort order: asc, desc (default: desc)

GET /api/characters?page=1&limit=20&sort=popularity

GET /api/characters/:id

Recuperar un solo personaje por ID

GET /api/characters/clm9xzw0x0000qw0xg6h7k9xy

GET /api/search

Buscar personajes

Parámetros de Consulta:

q - Search query
type - Filter by character type
popularity - Filter by popularity: high, medium, low
hasRelationships - Filter characters with relationships (true/false)
page - Page number (default: 1)
limit - Items per page (default: 20)

GET /api/search?q=tralalero&type=HYBRID_ANIMAL

GET /api/alphabet

Obtener personajes por primera letra

Parámetros de Consulta:

letter - Single letter A-Z or # for special characters (required)

GET /api/alphabet?letter=T

Formato de Respuesta

Todas las respuestas de la API siguen un formato JSON consistente:

{
  "characters": [...],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 127,
    "totalPages": 7
  }
}

Límite de Velocidad

La API es actualmente gratuita sin autenticación. Por favor, sé respetuoso y evita hacer solicitudes excesivas. Nos reservamos el derecho de implementar límites de velocidad en el futuro si es necesario.

¿Necesitas Ayuda?

Si tienes preguntas o necesitas ayuda con la API, contáctanos en Twitter