docs

2026-02-07 18:47:06 +01:00
parent 862a361a3d
commit ddbe59ead6
10 changed files with 1060 additions and 0 deletions
--- a/docs/apis-comparison.md
+++ b/docs/apis-comparison.md
@@ -0,0 +1,176 @@
+# Comparativa de APIs — cobertura, límites, coste y calidad
+
+**Introducción**
+Comparar APIs públicas y comerciales que aportan metadatos (covers, screenshots, géneros, desarrolladores), y datos de precio/ofertas. Las decisiones de integración deben priorizar cobertura, coste (preferencia: gratuito), calidad y facilidad de uso.
+
+**Nota:** límites y condiciones pueden cambiar — verificar TOS antes de integración.
+
+---
+
+## Resumen por API
+
+### IGDB (Internet Games Database)
+
+- **Resumen:** Base de datos muy completa (propiedad de Twitch/Amazon) con endpoints para juegos, covers, screenshots, plataformas, ratings, compañías y más.
+- **Autenticación / Requisitos:** OAuth vía Twitch (Client ID + Client Secret → token) — requiere cuenta Twitch y 2FA para registrar apps.
+- **Datos principales:** covers, screenshots, genres, developers, ESRB/PEGI, platforms, videos, websites, age ratings, tags.
+- **Rate limits / cuotas:** 4 peticiones/segundo; hasta 8 peticiones abiertas (si se excede → 429 Too Many Requests).
+- **Fecha verificación:** 2026-02-07
+- **TOS / Developer Agreement:** Twitch Developer Service Agreement — https://www.twitch.tv/p/legal/developer-agreement/
+- **Cláusula clave:** "There is a rate limit of 4 requests per second. If you go over this limit you will receive a response with status code `429 Too Many Requests`." — https://api-docs.igdb.com/
+- **Costes / modelo:** Gratuito para uso no comercial; acuerdos comerciales para partners (atribución en caso de partnership).
+- **Enlace:** https://api-docs.igdb.com/
+
+---
+
+### RAWG
+
+- **Resumen:** Gran base de datos (medio millón de juegos), buena para metadata general y enlaces a tiendas.
+- **Autenticación / Requisitos:** API key en query string (`key=YOUR_API_KEY`).
+- **Datos principales:** descripciones, screenshots, plataformas, géneros, ratings, enlaces a tiendas, playtime estimado.
+- **Rate limits / cuotas:** Planes gratuitos con límites (ej. free tier limitada) y planes comerciales con mayor cuota (p.ej. hasta 50k requests/mes en planes de negocio).
+- **Fecha verificación:** 2026-02-07
+- **TOS / Developer Agreement:** https://rawg.io/tos_api
+- **Cláusula clave:** "Free for personal use as long as you attribute RAWG as the source of the data and/or images and add an active hyperlink from every page where the data of RAWG is used. No data redistribution." — https://rawg.io/tos_api
+- **Costes / modelo:** Free tier para proyectos personales; planes comerciales (pago mensual) para uso en productos con gran tráfico.
+- **Enlace:** https://rawg.io/apidocs
+
+---
+
+### TheGamesDB
+
+- **Resumen:** Base de datos comunitaria para juegos y artwork, con API pública v2.
+- **Autenticación / Requisitos:** Registro y uso de API key (ver docs); repositorio público del proyecto (GPLv3 para el código del servidor).
+- **Datos principales:** imágenes, covers, plataformas, metadatos básicos.
+- **Rate limits / cuotas:** No siempre documentados públicamente (consultar docs/registro).
+- **Fecha verificación:** 2026-02-07
+- **TOS / Developer Agreement:** No documentado públicamente — consultado https://api.thegamesdb.net/ y https://github.com/TheGamesDB/TheGamesDBv2 (código bajo GPL‑3.0)
+- **Cláusula clave:** No documentado públicamente — verificar con el equipo de TheGamesDB antes de uso comercial/redistribución.
+- **Enlace:** https://api.thegamesdb.net/
+
+---
+
+### ScreenScraper
+
+- **Resumen:** Servicio francés orientado a frontends, con enorme cantidad de media y opciones de scraping.
+- **Autenticación / Requisitos:** Cuenta en ScreenScraper; modelo de soporte/donación que habilita límites mayores.
+- **Datos principales:** screenshots, boxart, videos, manuals, metadata comunitaria.
+- **Rate limits / cuotas:** Planes por donación (ej.: 50.000 scrapes/día en niveles básicos; aumentos en niveles superiores).
+- **Fecha verificación:** 2026-02-07
+- **TOS / Developer Agreement:** https://www.screenscraper.fr/
+- **Cláusula clave:** "Niveles de donación ofrecen límites distintos (p.ej. 50.000 scrapes/día en nivel Bronze); consultar la cuenta para límites exactos." — https://www.screenscraper.fr/
+- **Costes / modelo:** Donación / suscripción para aumentar cuotas y velocidad.
+- **Enlace:** https://www.screenscraper.fr/
+
+---
+
+### MobyGames
+
+- **Resumen:** Base histórica con screenshots, covers, reviews y credits; muy usada por investigación y metadata profunda.
+- **Autenticación / Requisitos:** API y/o MobyPlus; la API requiere registro y suscripción.
+- **Datos principales:** screenshots, covers, credits, precios históricos limitados.
+- **Rate limits / cuotas:** Non-commercial API requests are limited to 720 per hour (one every five seconds) with a max request rate of 1 per/second.
+- **Fecha verificación:** 2026-02-07
+- **TOS / Developer Agreement:** https://www.mobygames.com/api/subscribe/
+- **Cláusula clave:** "Non-commercial API requests are limited to 720 per hour (one every five seconds) with a max request rate of 1 per/second." — https://www.mobygames.com/api/subscribe/
+- **Costes / modelo:** Acceso vía suscripción / MobyPro; contactar para condiciones comerciales.
+- **Enlace:** https://www.mobygames.com/api/subscribe/
+
+---
+
+### PriceCharting
+
+- **Resumen:** Fuente especializada en historial de precios para juegos físicos y coleccionables.
+- **Autenticación / Requisitos:** API documentada en el sitio; el acceso completo requiere suscripción / token pagado.
+- **Datos principales:** precios históricos, condiciones (complete, loose), plataforma y comparables de mercado.
+- **Rate limits / cuotas:** No siempre publicadas públicamente; contactar a PriceCharting para detalles.
+- **Fecha verificación:** 2026-02-07
+- **TOS / Developer Agreement:** https://www.pricecharting.com/api-documentation (ver también https://www.pricecharting.com/page/terms-of-service)
+- **Cláusula clave:** "API's are a premium tool. You must have a paid subscription to access the API." — https://www.pricecharting.com/api-documentation
+- **Costes / modelo:** Servicio comercial (licencias / API keys pagadas).
+- **Enlace:** https://www.pricecharting.com/api-documentation
+
+---
+
+### IsThereAnyDeal (Itad)
+
+- **Resumen:** Agregador de ofertas con histórico y mapeo de keys/tiendas; útil para tracking de ofertas digitales.
+- **Autenticación / Requisitos:** API Key (docs en https://docs.isthereanydeal.com/).
+- **Datos principales:** price history, deals, store IDs, game mappings.
+- **Rate limits / cuotas:** Access to API is rate limited and subject to change (limits provided in headers); contactar si necesita mayor cuota.
+- **Fecha verificación:** 2026-02-07
+- **TOS / Developer Agreement:** https://docs.isthereanydeal.com/
+- **Cláusula clave:** "You MUST NOT change provided data in any way. You SHOULD provide a link to IsThereAnyDeal.com or mention IsThereAnyDeal API." — https://docs.isthereanydeal.com/
+- **Costes / modelo:** Free tier; acuerdos comerciales para uso intensivo.
+- **Enlace:** https://docs.isthereanydeal.com/
+
+---
+
+### eBay
+
+- **Resumen:** Fuente de datos de mercado (listings, precios vendidos) para estimar valor real de mercado.
+- **Autenticación / Requisitos:** Registro en eBay Developers Program; claves y OAuth para endpoints de venta/completed items.
+- **Datos principales:** listados, historiales vendidos (completed), especificaciones de artículos.
+- **Rate limits / cuotas:** Límite de llamadas por aplicación; eBay puede limitar y suspender acceso si se exceden los límites.
+- **Fecha verificación:** 2026-02-07
+- **TOS / Developer Agreement:** https://developer.ebay.com/join/api-license-agreement
+- **Cláusula clave:** "You may not sell, rent, trade, distribute, lease (or otherwise commercialize), copy, store or modify eBay Content, other than for the purposes allowed by this API License Agreement." y "eBay reserves the right to limit the number of periodic API calls you are allowed to make." — https://developer.ebay.com/join/api-license-agreement
+- **Costes / modelo:** Free para desarrolladores con límites; uso intensivo o comerciales pueden requerir acuerdos o certificaciones.
+- **Enlace:** https://developer.ebay.com/
+
+---
+
+## Tabla resumida
+
+| API            | Data types                                              | Auth                             | Free / Paid                                | Fecha verificación | Licencia / Nota legal                                                                                   | Notes                                                          |
+| -------------- | ------------------------------------------------------- | -------------------------------- | ------------------------------------------ | ------------------ | ------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------- |
+| IGDB           | covers, screenshots, genres, ESRB, companies, platforms | OAuth via Twitch                 | Free (non-commercial); commercial partners | 2026-02-07         | TOS: https://www.twitch.tv/p/legal/developer-agreement/                                                 | 4 rps rate limit; muy completa                                 |
+| RAWG           | games, screenshots, stores, ratings, playtime           | API key (query param)            | Free tier; paid commercial plans           | 2026-02-07         | TOS: https://rawg.io/tos_api (atribución requerida)                                                     | Free for personal use; atribución requerida; no redistribución |
+| TheGamesDB     | images, basic metadata                                  | API key (registro)               | Free / community                           | 2026-02-07         | Repo/TOS: https://github.com/TheGamesDB/TheGamesDBv2 (codigo GPL-3.0) / TOS no documentada públicamente | No TOS público claro; código backend GPL‑3.0                   |
+| ScreenScraper  | images, videos, manuals                                 | Account + token (donation tiers) | Donation / paid tiers                      | 2026-02-07         | TOS: https://www.screenscraper.fr/ (donation/tiers)                                                     | Donación/premium para mayores cuotas (p.ej. 50k/día)           |
+| PriceCharting  | price history                                           | API key / commercial             | Paid                                       | 2026-02-07         | Paid: https://www.pricecharting.com/api-documentation                                                   | API premium; requiere suscripción                              |
+| IsThereAnyDeal | deals, price history                                    | API key                          | Free tier / paid                           | 2026-02-07         | TOS: https://docs.isthereanydeal.com/                                                                   | Requiere atribución; prohíbe modificar datos                   |
+| MobyGames      | screenshots, credits, covers                            | Subscribe / API key              | Paid / subscription                        | 2026-02-07         | Paid/Subscribe: https://www.mobygames.com/api/subscribe/                                                | Access via subscription; non-commercial rate limits documented |
+| eBay           | listings, sold data                                     | eBay Dev keys / OAuth            | Free (with limits)                         | 2026-02-07         | TOS: https://developer.ebay.com/                                                                        | Terms restrict distribution; API License Agreement             |
+
+---
+
+## Conclusión y recomendación para MVP
+
+Recomiendo un **set inicial de APIs (priorizado)**: **IGDB, RAWG, TheGamesDB, ScreenScraper, PriceCharting, IsThereAnyDeal.**
+
+- **Por qué:** IGDB + RAWG cubren **amplia metadata** y campos útiles (genres, plataformas, covers); TheGamesDB aporta **artwork comunitario**; ScreenScraper cubre assets específicos para ROM/frontends (videos/logos); PriceCharting e IsThereAnyDeal cubren **precios físicos y ofertas digitales** respectivamente.
+- **Prioridad:** 1) IGDB (calidad + licencia accesible) 2) RAWG (cobertura y datos de tiendas) 3) TheGamesDB (artwork) 4) ScreenScraper (media específica) 5) PriceCharting (precios físicos) 6) IsThereAnyDeal (ofertas digitales).
+
+---
+
+## Vacíos y verificación pendiente
+
+- **APIs que requieren suscripción / acuerdos comerciales:** PriceCharting (API premium, requiere suscripción), MobyGames (MobyPro/API requiere suscripción), EmuMovies (servicio comercial con TOS y cuentas), y en casos especiales eBay (certificaciones / acuerdos adicionales para ciertos permisos).
+- **PriceCharting:** la documentación de la API existe pero el acceso completo está sujeto a registro/pago; no se publicó límite público durante la verificación.
+- **MobyGames:** API y límites requieren suscripción/registro; hay que contactar para condiciones comerciales.
+- **eBay:** múltiples APIs y límites por endpoint; requiere revisar caso de uso específico y cumplimiento del API License Agreement.
+- **Notas:** Algunas APIs (ScreenScraper) usan modelos por donación/premium para aumentar cuotas; en APIs sin límites públicos, contactar al proveedor para confirmar condiciones.
+
+---
+
+## Fuentes
+
+- IGDB API docs: https://api-docs.igdb.com/ — TOS: https://www.twitch.tv/p/legal/developer-agreement/
+- RAWG API & TOS: https://rawg.io/apidocs / https://rawg.io/tos_api
+- TheGamesDB API / repo: https://api.thegamesdb.net/ / https://github.com/TheGamesDB/TheGamesDBv2/blob/master/LICENSE
+- ScreenScraper: https://www.screenscraper.fr/
+- MobyGames API: https://www.mobygames.com/api/subscribe/
+- PriceCharting API & Terms: https://www.pricecharting.com/api-documentation / https://www.pricecharting.com/page/terms-of-service
+- IsThereAnyDeal docs/TOS: https://docs.isthereanydeal.com/
+- eBay API License Agreement: https://developer.ebay.com/join/api-license-agreement
+
+## Metadatos
+
+- **Autor:** Quasar (investigación automatizada)
+- **Fecha verificación:** 2026-02-07
+- **Última actualización:** 2026-02-07
+
+---
+
+**Nota:** Si quieres, puedo preparar una matriz técnica (endpoints concretos, ejemplos de requests y una PoC de integración para 2 APIs prioritarias).