archlos.com
Developers & Open Data

Archlos API Documentation

A public, free, read-only (GET) REST API designed for hardware diagnostic utilities, launchers, frontends, emulators, and community applications.

FormatStandard JSON

UTF-8 formatted and indented responses.

CORSEnabled (*)

Directly accessible from browsers, mobile apps, and scripts.

AuthenticationNone (No API Key)

Free open access for all GET endpoints.

1. Ports Catalog & Compatibility Overview

Returns the complete catalog of game ports, overall compatibility ratings, average FPS, developer info, and GPU family averages (Adreno, Mali/Immortalis).

GEThttps://archlos.com/api/ports.json
cURL Example:curl -X GET "https://archlos.com/api/ports.json"
Response format:
{
  "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. Hardware Benchmark Reports per Game

Returns technical details for a specific game port along with all community benchmark submissions (device models, GPUs, SoCs, RAM, FPS, and technical configuration notes).

GEThttps://archlos.com/api/ports/{slug}.json
cURL Example:curl -X GET "https://archlos.com/api/ports/celeste.json"
Response format:
{
  "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. Hardware & Device Search Endpoint

Returns device models tested by the community (e.g., Xiaomi, POCO, Samsung, Redmi) along with the list of tested games and compatibility metrics for that specific hardware.

GEThttps://archlos.com/api/devices.json
cURL Example:curl -X GET "https://archlos.com/api/devices.json"
Response format:
{
  "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. JavaScript Integration Example

Ready-to-use client function to look up whether a user's phone (e.g. "POCO F5" or "Snapdragon 8") has tested and compatible games in the database:

JSFrontend / Client Snippet
Integration Code:
async function findGamesForDevice(searchQuery) {
  const res = await fetch('https://archlos.com/api/devices.json');
  const { data } = await res.json();

  const query = searchQuery.toLowerCase().trim();
  // Filter by matching phone model, processor, or GPU
  const matched = data.filter(d => 
    d.device_model.toLowerCase().includes(query) ||
    (d.soc_cpu && d.soc_cpu.toLowerCase().includes(query))
  );

  // List all compatible games found
  return matched.flatMap(d => d.games.map(g => ({
    device: d.device_model,
    ...g
  })));
}

// Example usage:
const games = await findGamesForDevice('Xiaomi');
console.log(games);

Usage Terms & Attribution

Data compiled by the Archlos community is public and free to use. When integrating these endpoints into your app, diagnostic utility, or frontend, a simple attribution link to archlos.com is appreciated.