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

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, limite (máx. 100); sin q, los últimos
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-70933

{
    "id": "LDT-70933",
    "titulo": "Virtual Skate",
    "ano": 2025,
    "lanzamiento": {
        "fecha": "21 AGO 2025",
        "proximamente": false
    },
    "url_ficha": "https://ludoteca.dev/juego/virtual-skate",
    "url_permanente": "https://ludoteca.dev/id/LDT-70933",
    "descripcion": "Experience next level board control, skate with friends, and film insane tricks in the most immersive skateboarding game ever made.",
    "idioma_descripcion": "es",
    "portada": {
        "grande": "https://ludoteca.dev/portadas/virtual-skate-h-162e1c0a.webp",
        "mini": "https://ludoteca.dev/portadas/virtual-skate-h-162e1c0a.webp",
        "vertical": null,
        "horizontal": "https://ludoteca.dev/portadas/virtual-skate-h-162e1c0a.webp",
        "origen": {
            "vertical": null,
            "horizontal": "https://shared.akamai.steamstatic.com/store_item_assets/steam/apps/3583790/d76914816624edea54a27957d889d1e22b87edba/header.jpg?t=1786949592"
        }
    },
    "estudio": "Flip Axis Studios",
    "desarrollador": null,
    "editora": "Flip Axis Studios",
    "pais": null,
    "empresas": {
        "desarrolladores": [
            {
                "nombre": "Flip Axis Studios",
                "slug": "flip-axis-studios",
                "pais": null,
                "url": "https://ludoteca.dev/empresa/flip-axis-studios"
            }
        ],
        "editoras": [
            {
                "nombre": "Flip Axis Studios",
                "slug": "flip-axis-studios",
                "pais": null,
                "url": "https://ludoteca.dev/empresa/flip-axis-studios"
            }
        ]
    },
    "tiendas": [
        {
            "clave": "steam",
            "nombre": "Steam",
            "id": "3583790",
            "url": "https://store.steampowered.com/app/3583790/",
            "icono": "https://ludoteca.dev/iconos/steam.svg",
            "color": "#1b2838",
            "fuente": "steam",
            "titulo": "Virtual Skate",
            "editora": "Flip Axis Studios",
            "desarrollador": "Flip Axis Studios",
            "fecha": "21 AGO 2025"
        }
    ],
    "otras_versiones": [],
    "ids": {}
}

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

Plugin «ludoteca.dev Ficha de Juego»: muestra una tarjeta con portada, estudio, país y botones a las tiendas, que se adapta al tema claro u oscuro de tu web.

shortcode: [ludoteca_juego id="LDT-1234"] · o url="…" (ficha de ludoteca.dev o de Steam), slug="…", steam="…"
bloque: «Ficha de juego ludoteca.dev» en el editor; pegar una URL de ludoteca.dev o de Steam en su propia línea lo convierte solo
caché: 12 horas por ficha: tu web no depende de que ludoteca.dev responda en cada visita

ludoteca@dev:~$ ludoteca --help embed

La misma tarjeta del plugin, para cualquier web: Ghost, Blogger, Wix, Notion, HTML a mano… Cada ficha tiene su código listo para copiar.

script: <blockquote class="ludoteca-juego" data-id="LDT-1819">…</blockquote> + <script async src="https://ludoteca.dev/embed.js"></script> · ajusta la altura sola; sin JavaScript queda el enlace
iframe: <iframe src="https://ludoteca.dev/embed/<id>" width="600" height="230">
opciones: data-tema="claro|oscuro" · data-descripcion="0" (en el iframe: ?tema=… y ?descripcion=0); por defecto sigue el tema del sistema
oEmbed: https://ludoteca.dev/oembed?url=<url de la ficha> · las fichas lo anuncian: las plataformas compatibles convierten el enlace pegado en la tarjeta

ludoteca@dev:~$ ludoteca --help badge

Insignias SVG «disponible en» para la web, el presskit o el README de un juego. Se actualizan solas si el juego sale en más tiendas.

url: https://ludoteca.dev/insignia/<id>.svg
variantes: ?estilo=iconos · ?tema=claro · ?tienda=steam
código: cada ficha tiene el suyo listo para copiar (html y markdown)