Read a work
get_workRetrieve a classical music work's details from IMSLP: title, composer, dates, key, instrumentation, and score/recording counts, with copyright status per jurisdiction. Link to the work page.
Instructions
Read one work on IMSLP: its title and alternative titles, the composer, the opus and catalogue numbers, the year it was written and the year it was first published, the dedication, the key, the instrumentation, the style and period, and how many scores and recordings the page holds. Address a work by its page title, written 'Work (Composer)', for example 'Nocturnes, Op.9 (Chopin, Frédéric)', or by the page id. Dates and durations come back in the wording the page used: 'ca.1830' stays 'ca.1830', because a bare year would state a certainty the library declined to state. A facet the page leaves empty comes back null rather than guessed. A work holding a few editions comes back with them, files included. One holding many comes back with 'editions' null and 'editions_truncated' true, and list_work_files pages through them. The copyright of a score is stated per jurisdiction: 'Public Domain - Non-PD US' is free in Canada and the European Union and protected in the United States, so never report a score as public domain without saying where. No score file is downloaded or linked; the work page is what an answer links to. When you show a work to a user, credit IMSLP and link that page.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | The title of the work's page, written 'Work (Composer)', for example 'Nocturnes, Op.9 (Chopin, Frédéric)'. Pass this or 'pageid', not both. | |
| pageid | No | The page id a search returns. Pass this or 'page', not both. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| key | Yes | ||
| notes | Yes | ||
| title | Yes | ||
| pageid | Yes | The number IMSLP gives the page. Known when the work was addressed by it, and null when it was addressed by title: a rendered page states its title and nothing else. | |
| source | Yes | ||
| license | Yes | ||
| composer | Yes | ||
| editions | Yes | Every edition the page holds, files included. Null when the work holds more of them than one answer carries, and list_work_files then pages through them. | |
| language | Yes | ||
| page_url | Yes | ||
| sections | Yes | The sections of the page, with the number of entries the site counts in each. | |
| movements | Yes | ||
| dedication | Yes | ||
| librettist | Yes | ||
| page_title | Yes | ||
| authorities | Yes | Records of the work in library catalogues: VIAF, LCCN, WorldCat, BNF, GND. | |
| piece_style | Yes | ||
| external_links | Yes | ||
| composer_period | Yes | ||
| instrumentation | Yes | ||
| redirected_from | Yes | The title asked for, when it redirected here. | |
| average_duration | Yes | ||
| composition_year | Yes | As published, for example 'ca.1830'. | |
| genre_categories | Yes | ||
| alternative_title | Yes | ||
| composer_page_url | Yes | ||
| copyright_summary | Yes | The terms the scores of this work are published under, one entry per distinct statement, with the number of editions on the page carrying it. Stated whether or not the editions themselves fit in this answer. | |
| extra_information | Yes | ||
| first_performance | Yes | ||
| first_publication | Yes | ||
| editions_truncated | Yes | ||
| opus_catalogue_number | Yes | ||
| internal_catalogue_number | Yes |