API Documentation

Free API for programmatic access to the expression map database.

Base URL

https://articulations.cubbycomposer.com/api/v1

Endpoints

GET /libraries.json

Returns a list of all available libraries with basic metadata.

{
  "version": "1.0",
  "generated": "2026-01-29T10:00:00.000Z",
  "count": 19,
  "libraries": [
    {
      "path": "vsl/synchron-brass",
      "name": "Synchron Brass",
      "developer": "Vienna Symphonic Library",
      "category": "brass",
      "exports": ["cubase"],
      "tags": ["brass", "orchestral", "synchron"]
    },
    ...
  ]
}

GET /libraries/{developer}/{library}.json

Returns detailed information about a specific library, including download URLs.

{
  "path": "vsl/synchron-brass",
  "name": "Synchron Brass",
  "developer": "Vienna Symphonic Library",
  "category": "brass",
  "exports": ["cubase"],
  "tags": ["brass", "orchestral"],
  "website": "https://www.vsl.co.at/",
  "attribution": {
    "original_author": "Jared Thirsk",
    "original_license": "Unlicense"
  },
  "downloads": {
    "cubase": {
      "count": 15,
      "files": [
        {
          "name": "SYB Bass trombone.expressionmap",
          "url": "https://github.com/.../SYB%20Bass%20trombone.expressionmap"
        },
        ...
      ]
    }
  },
  "github": "https://github.com/.../vsl/synchron-brass"
}

GET /developers.json

Returns all developers with their libraries grouped.

{
  "version": "1.0",
  "count": 6,
  "developers": [
    {
      "name": "Vienna Symphonic Library",
      "libraries": [
        { "path": "vsl/synchron-brass", "name": "Synchron Brass", ... },
        ...
      ]
    },
    ...
  ]
}

GET /categories.json

Returns libraries grouped by category (strings, brass, woodwinds, etc.).

{
  "version": "1.0",
  "categories": {
    "strings": [
      { "path": "vsl/synchron-strings-pro", "name": "Synchron Strings Pro", ... }
    ],
    "brass": [
      { "path": "vsl/synchron-brass", "name": "Synchron Brass", ... }
    ],
    ...
  }
}

Usage Examples

JavaScript/TypeScript

const response = await fetch(
  'https://articulations.cubbycomposer.com/api/v1/libraries.json'
);
const data = await response.json();
console.log(data.libraries);

cURL

curl https://articulations.cubbycomposer.com/api/v1/libraries.json

Download a file

# Get library info with download URLs
curl https://articulations.cubbycomposer.com/api/v1/libraries/vsl/synchron-brass.json

# Download an expression map directly
curl -LO "https://github.com/.../SYB%20Bass%20trombone.expressionmap"

Rate Limits & Terms

- No authentication required
- No rate limits (static files served via CDN)
- Free for any use, commercial or personal
- Attribution appreciated but not required
- Individual expression maps have their own licenses (see attribution field)