ludoteca@dev:~$ ludoteca --help api
API de ludoteca.dev
JSON público y gratuito, sin registro ni clave. Para webs, bots, apps o lo que se te ocurra. ¿Necesitas todo de golpe? La tabla completa de equivalencias se descarga en ~/datos (CSV y JSON, licencia ODbL).
→ referencia interactiva · prueba cada endpoint desde el navegador · openapi.json · para Postman, Insomnia o generar un cliente en tu lenguaje
¿No programas y solo quieres mostrar juegos en tu web? → ~/para-tu-web (plugin de WordPress y tarjetas)
- GET
https://ludoteca.dev/api/v1/id/<id>· por id de ludoteca.dev (recomendado: no cambia nunca)- GET
https://ludoteca.dev/api/v1/juego/<slug>- GET
https://ludoteca.dev/api/v1/steam/<appid>· por appid de Steam; si la ficha no existe se crea (202 = en preparación)- GET
https://ludoteca.dev/api/v1/steam?appids=620,1145360· hasta 100 appids: sus fichas y tiendas (no crea fichas)- GET
https://ludoteca.dev/api/v1/externo/<fuente>/<id>· por su id en otra tienda o base de datos: xbox, playstation, nintendo, gog, wikidata, igdb… (lista)- GET
https://ludoteca.dev/api/v1/externo/<fuente>?ids=a,b,c· hasta 100 ids de golpe: la tabla de equivalencias a la carta- GET
https://ludoteca.dev/api/v1/empresa/<slug>· estudio o editora con su país y sus juegos- GET
https://ludoteca.dev/api/v1/buscar?q=<texto>· filtros: tienda, pais, ano, genero, saga, motor, fisico (1 o la plataforma), limite (máx. 100); sin q, los últimos- GET
https://ludoteca.dev/api/v1/indice/<tipo>· generos, sagas, motores, paises o anos, cada uno con su clave para filtrar y su número de juegos- GET
https://ludoteca.dev/api/v1/info· cifras y tiendas ·/api/v1/aleatorio· una ficha al azar- formato
- JSON · CORS abierto · gratis, sin registro ni clave
- versión
- v1 estable: solo se añadirán campos, nunca se quitarán ni cambiarán de tipo (cabecera X-API-Version)
- errores
404no existe ·202ficha en preparación (reintenta en 5 min) ·429límite superado (Retry-After) ·400petición mal formada- límite
- 60 peticiones/minuto por IP (cachea tú también)
- id
- identificador fijo de cada ficha, como
LDT-1234; enlace permanente:/id/LDT-1234 - slug
- el final de la URL de la ficha:
/juego/portal-2
ludoteca@dev:~$ curl -s https://ludoteca.dev/api/v1/id/LDT-143023
{
"id": "LDT-143023",
"titulo": "Nekopara Sekai Connect",
"titulo_original": "ネコぱら セカイコネクト",
"ano": 2026,
"lanzamiento": {
"fecha": "18 NOV 2026",
"proximamente": false
},
"url_ficha": "https://ludoteca.dev/juego/nekopara-sekai-connect",
"url_permanente": "https://ludoteca.dev/id/LDT-143023",
"descripcion": "A heartwarming Neko comedy that connects these felines from all across the globe! With over 7 million copies sold worldwide, the latest entry in the popular adventure game series NEKOPARA is here!",
"idioma_descripcion": "es",
"traduccion_automatica": false,
"portada": {
"grande": "https://ludoteca.dev/portadas/nekopara-sekai-connect-v-c36da8ad.webp",
"mini": "https://ludoteca.dev/portadas/nekopara-sekai-connect-h-61e331d4.webp",
"vertical": "https://ludoteca.dev/portadas/nekopara-sekai-connect-v-c36da8ad.webp",
"horizontal": "https://ludoteca.dev/portadas/nekopara-sekai-connect-h-61e331d4.webp",
"origen": {
"vertical": "https://shared.akamai.steamstatic.com/store_item_assets/steam/apps/4437450/52d8cb24cc3b3ca390cd6664c21bf6e3d4ae2975/library_capsule.jpg?t=1795004829",
"horizontal": "https://shared.akamai.steamstatic.com/store_item_assets/steam/apps/4437450/d56038a39c03287c9fd867997bf466cf37f4aa82/header.jpg?t=1795004829"
}
},
"captura": null,
"estudio": "GOOD SMILE COMPANY",
"desarrollador": null,
"editora": "GOOD SMILE COMPANY",
"pais": null,
"pais_fuente": null,
"empresas": {
"desarrolladores": [
{
"nombre": "Good Smile Company",
"nombre_original": null,
"slug": "good-smile-company",
"pais": "JP",
"url": "https://ludoteca.dev/empresa/good-smile-company"
}
],
"editoras": [
{
"nombre": "Good Smile Company",
"nombre_original": null,
"slug": "good-smile-company",
"pais": "JP",
"url": "https://ludoteca.dev/empresa/good-smile-company"
}
]
},
"tiendas": [
{
"clave": "steam",
"nombre": "Steam",
"id": "4437450",
"url": "https://store.steampowered.com/app/4437450/",
"icono": "https://ludoteca.dev/iconos/steam.svg",
"color": "#1b2838",
"fuente": "steam",
"titulo": "Nekopara Sekai Connect",
"editora": "GOOD SMILE COMPANY",
"desarrollador": "GOOD SMILE COMPANY",
"fecha": "18 NOV 2026"
}
],
"otras_versiones": [],
"tiendas_retiradas": [],
"descatalogado": false,
"pack": false,
"packs": {
"incluye": [],
"incluido_en": []
},
"dlc": {},
"duracion": null,
"relaciones": [],
"compra_fisica": [],
"ids": {},
"tecnico": {
"pegi": null,
"esrb": null,
"idiomas": {
"textos": [
"en",
"ja",
"zh-Hans",
"zh-Hant"
],
"voces": [
"ja"
]
},
"accesibilidad": [
{
"clave": "volumen",
"nombre": "volumen por canales"
}
],
"tiendas": {
"steam": {
"plataformas": [
"windows"
],
"tamano_mb": 10240,
"tamano_tipo": "disco",
"requisitos": {
"min": {
"so": "Windows 11",
"cpu": "Intel Core i3-4360 or equivalent",
"ram": "8 GB de RAM",
"gpu": "NVIDIA GeForce GTX 760 or equivalent",
"directx": "Versión 11",
"disco": "10 GB de espacio disponible"
}
},
"logros": 13,
"funciones": [
"un_jugador",
"compras",
"gratis"
]
}
}
},
"valoraciones": {
"steam": {
"categoria": "variadas",
"texto": "Variadas",
"resenas": 72,
"url": "https://store.steampowered.com/app/4437450/#app_reviews_hash"
}
},
"compatibilidad": {},
"etiquetas": {
"generos": [],
"saga": [],
"motor": [],
"acceso": [],
"fisico": [],
"descatalogado": []
}
}
ludoteca@dev:~$ ludoteca --help externo
¿Tienes el id de un juego en una tienda y quieres el de las demás? Pídelo por la fuente que conozcas y la respuesta trae todas:
tiendas[].id e ids.
- xbox → todo
curl -s https://ludoteca.dev/api/v1/externo/xbox/9P0478ZTXLZ4- eshop
/api/v1/externo/nintendo/1629870· el número del final de la URL de la eShop- wikidata
/api/v1/externo/wikidata?ids=Q67317244,Q55641138· por lotes- formatos
- vale el id tal como sale en la URL de la tienda; la lista de fuentes, con un ejemplo de cada una, en
/api/v1/externo
ludoteca@dev:~$ ludoteca --help mcp
Servidor MCP para asistentes de IA: conecta ludoteca.dev a Claude, ChatGPT, Cursor o VS Code y pregúntale en qué tiendas está un juego, quién lo edita en cada una o cuál es su id en Steam a partir del de Xbox. Responde con datos reales y enlaces a las fichas. Sin registro ni clave.
- url
https://ludoteca.dev/mcp· transporte HTTP («Streamable HTTP»)- claude
- Configuración → Conectores → Añadir conector personalizado → pega la url
- claude code
claude mcp add --transport http ludoteca https://ludoteca.dev/mcp- otros
- Cursor, VS Code, ChatGPT (modo desarrollador)…: añade un servidor MCP remoto con la url
- herramientas
buscar_juegos·ficha_juego·equivalencias·empresa·estadisticas· todas de solo lectura
ludoteca@dev:~$ ludoteca --help curl
La web responde en texto con colores a curl, wget y HTTPie: fichas, búsquedas, empresas y listados, directamente en tu terminal.
- buscar
curl ludoteca.dev/zelda· varias palabras: /dark+souls- ficha
curl ludoteca.dev/juego/hades- listados
curl ludoteca.dev/pais/es/2025· también /tienda/gog, /ano/2024- opciones
?color=0sin colores ·?formato=textodesde cualquier cliente
En Windows PowerShell escribe curl.exe (en PowerShell 5, curl es otro comando).
ludoteca@dev:~$ ludoteca --help wordpress embed badge
¿Solo quieres mostrar juegos en tu web? El plugin de WordPress, la tarjeta para cualquier web y las insignias están en ~/para-tu-web, sin una línea de código.