UniversoManga.COM
Noticias Fansubs Base de datos Enlaces
API

API pública

¿Tienes una web, una aplicación o un bot y quieres mostrar información de UniversoManga de forma automática? Con la API pública puedes consultar nuestra base de datos directamente desde tu propio proyecto sin necesidad de copiar datos a mano. Todo lo que devuelve la API es información que ya está disponible públicamente en la web, solo que en un formato que los programas pueden leer y procesar fácilmente.

Bots de Discord o Telegram

Crea un bot que responda con información de una obra, sus capítulos o los fansubs que la trabajan con solo escribir un comando.

Tu propia web o app

Muestra en tu página el catálogo de un fansub, los últimos capítulos publicados o la ficha completa de una obra, siempre actualizado.

Hojas de cálculo y scripts

Descarga el listado completo de obras de un fansub a Excel o Google Sheets, o automatiza consultas desde Python, JavaScript o cualquier otro lenguaje.

Para usar la API necesitas una API Key, que es una contraseña única que identifica tu proyecto. Esa clave se envía en cada petición como una cabecera HTTP y es la que permite el acceso. Si no tienes clave, contacta con nosotros por Telegram o Discord para solicitar la tuya de forma gratuita.

Todos los endpoints son de solo lectura (GET). Las respuestas siempre son JSON con la clave success: true si todo fue bien, o success: false con un mensaje de error si algo falló. Además, incluyen cached: true/false para indicar si el contenido está cacheado o ha sido actualizado en tiempo real.


Endpoints y ejemplos

Lista de fansubs.

curl -H "X-API-Key: TU_API_KEY" https://universomanga.com/api/v1/fansubs
{
  "success": true,
  "cached": false,
  "data": [
    {
      "id": 1,
      "name": "Fansub X",
      "short_name": "FX"
    }
  ]
}

Detalles de fansub por ID.

curl -H "X-API-Key: TU_API_KEY" https://universomanga.com/api/v1/fansubs/1
{
  "success": true,
  "cached": false,
  "data": {
    "id": 1,
    "name": "Fansub X",
    "description": "...",
    "links": []
  }
}

Listado de obras de un fansub con el mismo formato de /database y campo extra colaboracion[] por obra. El parámetro pagina es opcional (por defecto 1).

curl -H "X-API-Key: TU_API_KEY" https://universomanga.com/api/v1/fansubs/database/1
curl -H "X-API-Key: TU_API_KEY" https://universomanga.com/api/v1/fansubs/database/1/2
{
  "success": true,
  "data": {
    "page": 1,
    "per_page": 50,
    "total": 123,
    "has_more": true,
    "items": [
      {
        "id": 10,
        "title": "Obra",
        "colaboracion": [2, 7]
      }
    ]
  }
}

Listado paginado de obras, máximo 50 por página.

curl -H "X-API-Key: TU_API_KEY" https://universomanga.com/api/v1/database/1
{
  "success": true,
  "data": {
    "page": 1,
    "per_page": 50,
    "total": 1234,
    "items": [
      {
        "id": 10,
        "title": "Obra"
      }
    ]
  }
}

Información base de una obra.

curl -H "X-API-Key: TU_API_KEY" https://universomanga.com/api/v1/database/obra/info/10
{
  "success": true,
  "data": {
    "id": 10,
    "title": "Obra",
    "studio": "Studio",
    "year": 2020,
    "cover_url": "/img/covers/x.jpg",
    "anime": true,
    "manga": false,
    "fansubs": [1, 2]
  }
}

Capítulos manga de menor a mayor, 120 por página.

curl -H "X-API-Key: TU_API_KEY" https://universomanga.com/api/v1/database/obra/manga/10/1
{
  "success": true,
  "data": {
    "page": 1,
    "per_page": 120,
    "items": [
      {
        "chapter_number": 1,
        "title": "Capítulo",
        "rating_avg": 8.5
      }
    ]
  }
}

Secciones anime de la obra.

curl -H "X-API-Key: TU_API_KEY" https://universomanga.com/api/v1/database/obra/anime/10
{
  "success": true,
  "data": [
    {
      "id": 55,
      "title": "Temporada 1",
      "image_url": "/img/sections/s1.jpg"
    }
  ]
}

Capítulos de una sección anime, 50 por página.

curl -H "X-API-Key: TU_API_KEY" https://universomanga.com/api/v1/database/obra/seccion/55/1
{
  "success": true,
  "data": {
    "page": 1,
    "per_page": 50,
    "items": [
      {
        "id": 900,
        "title": "Episodio",
        "synopsis": "..."
      }
    ]
  }
}