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:
- https://dev-app.legatomedia.com/eprint-api/v1 - For development purposes
- 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:
- 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.
- Endpoint:
- Publishers List Endpoint:
- Endpoint:
GET /vendor/{vendorID}/publishers
- Purpose: Gets a list of publishers
- Endpoint:
- Music List Endpoint:
- Endpoint:
GET /vendor/{vendorID}/music
- Purpose: Get a paginated list of music for vendors
- Endpoint:
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.