find_recording
FREE. Discover recordings by artist name, or read one artist's sealed catalogue by artist_id. Supply exactly one of artist or artist_id, optionally title and page. Name search is partial: at most three artist files are read; artistCandidates lists the returned name matches, not necessarily every namesake or only census artists. Show returned recording matches with a brief incomplete-search warning; avoid attributing all matches to one artist without evidence or asking people to pick between indistinguishable IDs. If an artist ID was supplied, use it directly and confirm the selected name and ID. Select an artist_id from those candidates and page through that artist's matching recordings, 25 per page. Release pages are listing context, not proof of a release. Verify the intended recording by ISRC. A name-search miss does not establish absence.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page of matching recordings, 25 per page, with or without title | |
| title | No | Recording title, for example The Boys of Summer. Leave it out for all of the artist's recordings. | |
| artist | No | Artist name, for example Don Henley | |
| artist_id | No | Registry artist id from artistCandidates or an artist page; use instead of artist |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | ||
| @type | Yes | ||
| genre | No | ||
| query | Yes | ||
| scope | No | ||
| answer | Yes | ||
| status | Yes | ||
| artists | Yes | ||
| @context | Yes | ||
| coverage | No | ||
| numberOfItems | No | ||
| numberOfPages | No | ||
| similarArtists | No | ||
| itemListElement | No | ||
| artistCandidates | No |