5.0 Music Metadata API

Introducing the New Legato API for Sheet Music Metadata

In August of 2023, we released the beginning of a new Legato API specifically for getting Sheet Music Metadata. This API can be found at:

1. https://dev-app.legatomedia.com/eprint-api/v1 - For development purposes
2. https://app.legatomedia.com/eprint-api/v1 - For production purposes

API Endpoints for Sheet Music Metadata Retrieval

There are three endpoints within this API that are used for getting sheet music metadata:

1. Generate JWT Endpoint:
   • Endpoint: POST /vendor/{vendorID}/generateJWT
   • Purpose: Used for generating a JWT (JSON Web Token) using your Legato API key for any further vendor requests.
2. Publishers List Endpoint:
   • Endpoint: GET /vendor/{vendorID}/publishers
   • Purpose: Gets a list of publishers
3. Music List Endpoint:
   • Endpoint: GET /vendor/{vendorID}/music
   • Purpose: Get a paginated list of music for vendors

More details on the requests and responses for this API can be found with this OpenAPI specification:

- https://dev-app.legatomedia.com/legatoVendorSpec

Utilizing this API offers a range of advantages. It enables you to effortlessly access real-time music metadata, eliminating the need for manual export and import procedures from Legato. Moreover, the /music endpoint provides the added benefit of allowing you to precisely pinpoint altered music data beyond a designated timeframe, using the modifiedAfter parameter. Furthermore, through the extraction of publisher IDs from the /publishers route, you can selectively load distinct publishers' music metadata according to your requirements. Alternatively, if you prefer, you can load all associated publishers' data simultaneously by opting not to apply any publisher-based filters.