{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://www.monocrawl.com/schemas/apple_music/search.json","title":"apple_music/search data fields","description":"Optional data supplied by this operation. Null means unknown.","type":"object","properties":{"count":{"description":"Number of records in this response, not lifetime or total matches.","type":["number","null"]},"items":{"description":"Returned records. Source coverage and completeness vary.","type":["array"],"items":{"description":"Optional record supplied by this operation. Null means unknown.","type":"object","properties":{"album":{"description":"Optional album supplied by this operation. Null means unknown.","type":["object","null"],"properties":{"id":{"description":"Source identifier. Preserve the supplied type and exact value.","type":["string","null"]},"title":{"description":"Source title when supplied.","type":["string","null"]},"url":{"description":"Original source URL when supplied.","type":["string","null"]}},"additionalProperties":true},"artist":{"description":"Optional artist supplied by this operation. Null means unknown.","type":["object","null"],"properties":{"id":{"description":"Source identifier. Preserve the supplied type and exact value.","type":["string","null"]},"name":{"description":"Optional name supplied by this operation. Null means unknown.","type":["string","null"]},"url":{"description":"Original source URL when supplied.","type":["string","null"]}},"additionalProperties":true},"artwork_url":{"description":"Optional artwork url supplied by this operation. Null means unknown.","type":["string","null"]},"currency":{"description":"Optional currency supplied by this operation. Null means unknown.","type":["string","null"]},"disc_number":{"description":"Optional disc number supplied by this operation. Null means unknown.","type":["number","null"]},"duration_ms":{"description":"Optional duration ms supplied by this operation. Null means unknown.","type":["number","null"]},"explicit":{"description":"Optional explicit supplied by this operation. Null means unknown.","type":["boolean","null"]},"genre":{"description":"Optional genre supplied by this operation. Null means unknown.","type":["string","null"]},"id":{"description":"Source identifier. Preserve the supplied type and exact value.","type":["string","null"]},"kind":{"description":"Optional kind supplied by this operation. Null means unknown.","type":["string","null"]},"media_kind":{"description":"Optional media kind supplied by this operation. Null means unknown.","type":["string","null"]},"preview_url":{"description":"Optional preview url supplied by this operation. Null means unknown.","type":["string","null"]},"price":{"description":"Source price. Currency, taxes and availability depend on the listing.","type":["number","null"]},"release_date":{"description":"Optional release date supplied by this operation. Null means unknown.","type":["string","null"]},"title":{"description":"Source title when supplied.","type":["string","null"]},"track_number":{"description":"Optional track number supplied by this operation. Null means unknown.","type":["number","null"]},"url":{"description":"Original source URL when supplied.","type":["string","null"]}},"additionalProperties":true,"allOf":[{"anyOf":[{"required":["album"],"properties":{"album":{"description":"Optional album supplied by this operation. Null means unknown.","type":["object"],"properties":{"id":{"description":"Source identifier. Preserve the supplied type and exact value.","type":["string","null"]},"title":{"description":"Source title when supplied.","type":["string","null"]},"url":{"description":"Original source URL when supplied.","type":["string","null"]}},"additionalProperties":true}}},{"required":["artist"],"properties":{"artist":{"description":"Optional artist supplied by this operation. Null means unknown.","type":["object"],"properties":{"id":{"description":"Source identifier. Preserve the supplied type and exact value.","type":["string","null"]},"name":{"description":"Optional name supplied by this operation. Null means unknown.","type":["string","null"]},"url":{"description":"Original source URL when supplied.","type":["string","null"]}},"additionalProperties":true}}},{"required":["artwork_url"],"properties":{"artwork_url":{"description":"Optional artwork url supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["currency"],"properties":{"currency":{"description":"Optional currency supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["disc_number"],"properties":{"disc_number":{"description":"Optional disc number supplied by this operation. Null means unknown.","type":["number"]}}},{"required":["duration_ms"],"properties":{"duration_ms":{"description":"Optional duration ms supplied by this operation. Null means unknown.","type":["number"]}}},{"required":["explicit"],"properties":{"explicit":{"description":"Optional explicit supplied by this operation. Null means unknown.","type":["boolean"]}}},{"required":["genre"],"properties":{"genre":{"description":"Optional genre supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["id"],"properties":{"id":{"description":"Source identifier. Preserve the supplied type and exact value.","type":["string"],"minLength":1}}},{"required":["media_kind"],"properties":{"media_kind":{"description":"Optional media kind supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["preview_url"],"properties":{"preview_url":{"description":"Optional preview url supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["price"],"properties":{"price":{"description":"Source price. Currency, taxes and availability depend on the listing.","type":["number"]}}},{"required":["release_date"],"properties":{"release_date":{"description":"Optional release date supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["title"],"properties":{"title":{"description":"Source title when supplied.","type":["string"],"minLength":1}}},{"required":["track_number"],"properties":{"track_number":{"description":"Optional track number supplied by this operation. Null means unknown.","type":["number"]}}},{"required":["url"],"properties":{"url":{"description":"Original source URL when supplied.","type":["string"],"minLength":1}}}]}]}}},"additionalProperties":true,"required":["items"],"x-contract-version":"2026-09-22","x-validation-scope":"Required success payload structure; optional fields and source completeness remain separate.","examples":[{"count":0,"items":[{"album":{"id":"example","title":"example","url":"https://example.com/example"},"artist":{"id":"example","name":"example","url":"https://example.com/example"},"artwork_url":"https://example.com/example","currency":"example","disc_number":0,"duration_ms":0,"explicit":false,"genre":"example","id":"example","kind":"example","media_kind":"example","preview_url":"https://example.com/example","price":0,"release_date":"2026-09-01T12:00:00Z","title":"example","track_number":0,"url":"https://example.com/example"}]}]}