API Documentation

Overview

The Italian Brainrot Wiki API provides programmatic access to our character database. All API endpoints return JSON data and support CORS for browser-based applications.

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

Endpoints

GET /api/characters

Retrieve a paginated list of characters

Query Parameters:

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

Retrieve a single character by ID

GET /api/characters/clm9xzw0x0000qw0xg6h7k9xy

GET /api/search

Search for characters

Query Parameters:

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

Get characters by first letter

Query Parameters:

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

GET /api/alphabet?letter=T

Response Format

All API responses follow a consistent JSON format:

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

Rate Limiting

The API is currently free to use without authentication. Please be respectful and avoid making excessive requests. We reserve the right to implement rate limiting in the future if necessary.

Need Help?

If you have questions or need assistance with the API, please reach out to us on Twitter