API Documentation

Getting Started

The LaoUUU API aggregates metadata from multiple media sources including TMDB, IMDB, and more.

Base URL

http://localhost:8787

Endpoints are mounted at the root (no /api prefix).

Authentication

No authentication required for basic queries.

Endpoints

Search

GET /search
?q=query
&lang=en-US
&kind=movie|tv|anime

Description: Search for titles by query string

Parameters:

q (required): Search query
lang: Language code (default: en-US)
kind: Filter by type (movie, tv, anime)

Get Title Details

GET /title/:id
?lang=en-US

Description: Get detailed information about a specific title

Parameters:

id (required, in URL): Title ID
lang: Language code (default: en-US)

Response Format

All responses are JSON formatted. Successful responses return a 200 status code.

Title Object

{
  "id": "string",
  "title": "string",
  "overview": "string",
  "release_date": "ISO-8601",
  "runtime": "number",
  "genres": ["string"],
  "languages": ["string"],
  "ratings": [
    {
      "source": "string",
      "value": "string"
    }
  ],
  "cast": ["string"],
  "crew": ["string"],
  "budget": "number",
  "revenue": "number",
  "images": [
    {
      "type": "poster|backdrop",
      "url": "string"
    }
  ],
  "videos": [
    {
      "name": "string",
      "url": "string"
    }
  ]
}

Error Handling

Errors are returned with appropriate HTTP status codes and JSON error messages.

Status	Description
400	Bad Request
404	Not Found
500	Server Error

Examples

Search for movies

GET http://localhost:8000/api/search?q=the+matrix&kind=movie

Get trending content

GET http://localhost:8000/api/trending?lang=en-US

Get title details

GET http://localhost:8000/api/title/550?lang=en-US

Rate Limiting

API rate limiting may apply. Check response headers for rate limit information.