Search the people
search_peopleFind people on IMSLP by name, resolving spelling variations to canonical categories for reliable access to their works.
Instructions
Find the composers, editors, arrangers and performers of IMSLP by name. The library addresses a person by a category, written 'Category:Surname, Forename', and that is what list_person_works and get_person take. A name is written the library's own way, so searching finds it where guessing at the spelling does not. Some rows stand for another category rather than for a person: the library keeps a redirect for a name spelled differently, and 'redirect_to' names the category it leads to. Follow it rather than reading works under the redirect, which holds none. IMSLP publishes no count of what a search matched, so 'total' is always null. When you show a person to a user, credit IMSLP and link the page.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Rows to serve, from 1 to 50. | |
| query | Yes | What to look for among the people of the library. Words are matched across the page, not only titles. | |
| offset | No | Rows to skip, using the 'next_offset' a previous answer named. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | Yes | ||
| notes | Yes | ||
| query | Yes | The search as it reached the library. | |
| total | Yes | Always null: IMSLP publishes no count of what a search matched. | |
| offset | Yes | ||
| source | Yes | ||
| license | Yes | ||
| results | Yes | ||
| has_more | Yes | True when the library named an offset to continue from. | |
| returned | Yes | ||
| next_offset | Yes | The offset to read on from, as the library named it. Null when it named none. |