Lyoko API

Extract computed HTML/CSS from any URL and convert it to Figma-ready format. The API provides optimized output with style deduplication, compression, and encryption.

Quick Example

Fetch page data from any URL:

# Basic request
curl "https://v1.lyoko.xyz/api/fetch-url?url=https://example.com"

# With viewport
curl "https://v1.lyoko.xyz/api/fetch-url?url=https://example.com&viewport=mobile"

# Encrypted binary
curl "https://v1.lyoko.xyz/api/fetch-url?url=https://example.com&format=binary&encrypt=true&encryptionKey=secret" -o page.wtf

Endpoints

GET /api/fetch-url

Fetches computed HTML/CSS from the specified URL.

Optimization Options

All optimization options default to true for minimal output size. Set to false to disable.

Response Format

{
  "success": true,
  "data": {
    "url": "https://example.com",
    "viewport": "desktop",
    "viewportConfig": { "width": 1440, "height": 900 },
    "timestamp": "2024-01-15T10:30:00.000Z",
    "documentTitle": "Example Domain",
    "theme": { /* CSS variables */ },
    "styles": { /* Style dictionary */ },
    "documentElement": { /* DOM tree */ },
    "fonts": [...],
    "images": [...],
    "pageMetrics": {
      "totalElements": 67,
      "uniqueStyles": 43,
      "styleReferences": 24
    }
  }
}

{
  "success": true,
  "format": "base64",
  "data": "V1RGMQEBAAAAAAAAxwQAAP...",
  "metadata": {
    "originalSize": 67736,
    "binarySize": 12543,
    "compressed": true,
    "encrypted": false,
    "compressionRatio": 5.4
  }
}

Binary Format (WTF)

The WebToFigma Format (WTF) is a custom binary format optimized for size and security:

+----------------------------------------------------+
| Header (16 bytes)                                  |
|  - Magic bytes: "WTF1" (4 bytes)                   |
|  - Version: uint8 (1 byte)                         |
|  - Flags: uint8 (1 byte)                           |
|  - Reserved: (2 bytes)                             |
|  - Payload size: uint32 (4 bytes)                  |
|  - Checksum: uint32 (4 bytes)                      |
+----------------------------------------------------+
| Salt (16 bytes, if encrypted)                      |
+----------------------------------------------------+
| IV (12 bytes, if encrypted)                        |
+----------------------------------------------------+
| Auth Tag (16 bytes, if encrypted)                  |
+----------------------------------------------------+
| Payload (gzip compressed JSON)                     |
+----------------------------------------------------+

Decoding Binary

Use our decoder in Node.js or browser:

// Node.js
import { decodeFromBinary } from './lib/binary-format';
const data = await decodeFromBinary(buffer, 'password');

// Browser
<script src="/wtf-decoder.js"></script>
const data = await WTFDecoder.decode(arrayBuffer, 'password');

Error Handling

{
  "success": false,
  "error": {
    "code": "INVALID_URL",
    "message": "Invalid URL format",
    "details": "URL must start with http:// or https://"
  }
}