archlos.com
Desarrolladores & Open Data

Documentación de la API de Archlos

API pública, gratuita y de solo lectura (GET) pensada para herramientas de diagnóstico de hardware, lanzadores (frontends), emuladores y aplicaciones comunitarias.

FormatoJSON Estándar

UTF-8 con respuestas estructuradas e identadas.

CORSHabilitado (*)

Consumible desde navegadores, apps y scripts locales.

AutenticaciónNinguna (Sin API Key)

Acceso libre sin registro previo para consultas GET.

1. Catálogo General de Ports

Devuelve el directorio completo de juegos y ports registrados con su tier global de compatibilidad, media de FPS, enlaces y promedios por familia de GPU (Adreno, Mali/Immortalis).

GEThttps://archlos.com/api/ports.json
Ejemplo con cURL:curl -X GET "https://archlos.com/api/ports.json"
Estructura de respuesta:
{
  "meta": {
    "total": 5,
    "license": "Public / Community Knowledge",
    "endpoint": "https://archlos.com/api/ports.json",
    "generated_at": "2026-11-13T23:49:22.510Z"
  },
  "data": [
    {
      "id": "6b7b4008-d370-458b-9219-cc4e40abb145",
      "slug": "celeste",
      "title": "Celeste",
      "developer_porter": "Maddy Makes Games / FNA Android",
      "source_url": "https://github.com",
      "cover_url": "/images/og-default.svg",
      "logo_url": null,
      "port_source_type": "PC",
      "reports_count": 1,
      "top_rating": "platinum",
      "avg_fps": 60,
      "gpu_averages": {
        "Mali / Immortalis (Dimensity / Exynos)": {
          "rating": "platinum",
          "avg_fps": 60,
          "count": 1
        }
      },
      "url": "https://archlos.com/ports/celeste",
      "api_url": "https://archlos.com/api/ports/celeste.json"
    }
  ]
}

2. Detalle y Benchmarks de Hardware por Juego

Devuelve la ficha técnica de un port específico junto con todos los reportes individuales enviados por la comunidad (dispositivos, GPUs, SoCs, memoria RAM, FPS y notas técnicas de configuración).

GEThttps://archlos.com/api/ports/{slug}.json
Ejemplo con cURL:curl -X GET "https://archlos.com/api/ports/celeste.json"
Estructura de respuesta:
{
  "meta": {
    "generated_at": "2026-11-13T23:49:21.775Z",
    "url": "https://archlos.com/ports/celeste",
    "license": "Public / Community Knowledge"
  },
  "data": {
    "slug": "celeste",
    "title": "Celeste",
    "developer_porter": "Maddy Makes Games / FNA Android",
    "reports": [
      {
        "id": "18795374-99ca-4727-a347-bd843f07ba11",
        "device_model": "Xiaomi 11T",
        "soc_cpu": "Dimensity 1200",
        "gpu": "Mali-G77 MC9",
        "ram_gb": 8,
        "port_version": "v1.4.0.0",
        "rating": "platinum",
        "avg_fps": 60,
        "notes": "Smooth gameplay, native resolution without drops...",
        "upvotes": 0,
        "downvotes": 0
      }
    ]
  }
}

3. Búsqueda y Compatibilidad por Dispositivo / Hardware

Devuelve los modelos de dispositivos probados (ej. Xiaomi, POCO, Samsung, Redmi) junto con la lista de juegos compatibles y benchmarks registrados para ese equipo exacto.

GEThttps://archlos.com/api/devices.json
Ejemplo con cURL:curl -X GET "https://archlos.com/api/devices.json"
Estructura de respuesta:
{
  "meta": {
    "total_devices": 4,
    "endpoint": "https://archlos.com/api/devices.json"
  },
  "data": [
    {
      "device_model": "Xiaomi 11T",
      "soc_cpu": "Dimensity 1200",
      "gpu": "Mali-G77 MC9",
      "games": [
        {
          "game_slug": "celeste",
          "game_title": "Celeste",
          "rating": "platinum",
          "avg_fps": 60,
          "port_version": "v1.4.0.0",
          "notes": "Smooth gameplay, native resolution without drops..."
        }
      ]
    }
  ]
}

4. Ejemplo de Integración en JavaScript

Función práctica de ejemplo para consultar en tu aplicación o frontend si el celular del usuario (ej. "POCO F5" o "Snapdragon 8") cuenta con juegos testeados y compatibles:

JSCliente Web / Frontend Snippet
Código de integración:
async function findGamesForDevice(searchQuery) {
  const res = await fetch('https://archlos.com/api/devices.json');
  const { data } = await res.json();

  const query = searchQuery.toLowerCase().trim();
  // Filtra por coincidencia en modelo de celular, procesador o GPU
  const matched = data.filter(d => 
    d.device_model.toLowerCase().includes(query) ||
    (d.soc_cpu && d.soc_cpu.toLowerCase().includes(query))
  );

  // Lista todos los juegos compatibles encontrados
  return matched.flatMap(d => d.games.map(g => ({
    device: d.device_model,
    ...g
  })));
}

// Ejemplo de uso:
const games = await findGamesForDevice('Xiaomi');
console.log(games);

Términos de Uso y Atribución

Los datos recopilados por la comunidad de Archlos son públicos y gratuitos. Si integras estos datos en tu aplicación o herramienta, agradecemos una mención o enlace de atribución hacia archlos.com.