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
404 no existe · 202 ficha en preparación (reintenta en 5 min) · 429 límite superado (Retry-After) · 400 petició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=0 sin colores · ?formato=texto desde 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.