{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://www.monocrawl.com/schemas/spotify/track.json","title":"spotify/track data fields","description":"Optional data 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":{"album_type":{"description":"Optional album type supplied by this operation. Null means unknown.","type":["string","null"]},"artists":{"description":"Source array was empty in the reviewed captures; item fields remain unspecified.","type":["array","null"],"items":{}},"id":{"description":"Source identifier. Preserve the supplied type and exact value.","type":["string","null"]},"image_url":{"description":"Optional image url supplied by this operation. Null means unknown.","type":["string","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"]},"total_tracks":{"description":"Optional total tracks supplied by this operation. Null means unknown.","type":["number","null"]},"uri":{"description":"Optional uri supplied by this operation. Null means unknown.","type":["string","null"]},"url":{"description":"Original source URL when supplied.","type":["string","null"]}},"additionalProperties":true},"artists":{"description":"Optional artists supplied by this operation. Null means unknown.","type":["array","null"],"items":{"description":"Optional record 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"]},"uri":{"description":"Optional uri supplied by this operation. Null means unknown.","type":["string","null"]},"url":{"description":"Original source URL when supplied.","type":["string","null"]}},"additionalProperties":true}},"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"]},"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"]},"play_count":{"description":"Optional play count supplied by this operation. Null means unknown.","type":["number","null"]},"popularity":{"description":"Optional popularity supplied by this operation. Null means unknown.","type":["number","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"]},"uri":{"description":"Optional uri supplied by this operation. Null means unknown.","type":["string","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":{"album_type":{"description":"Optional album type supplied by this operation. Null means unknown.","type":["string","null"]},"artists":{"description":"Source array was empty in the reviewed captures; item fields remain unspecified.","type":["array","null"],"items":{}},"id":{"description":"Source identifier. Preserve the supplied type and exact value.","type":["string","null"]},"image_url":{"description":"Optional image url supplied by this operation. Null means unknown.","type":["string","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"]},"total_tracks":{"description":"Optional total tracks supplied by this operation. Null means unknown.","type":["number","null"]},"uri":{"description":"Optional uri supplied by this operation. Null means unknown.","type":["string","null"]},"url":{"description":"Original source URL when supplied.","type":["string","null"]}},"additionalProperties":true}}},{"required":["artists"],"properties":{"artists":{"description":"Optional artists supplied by this operation. Null means unknown.","type":["array"],"items":{"description":"Optional record 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"]},"uri":{"description":"Optional uri supplied by this operation. Null means unknown.","type":["string","null"]},"url":{"description":"Original source URL when supplied.","type":["string","null"]}},"additionalProperties":true}}}},{"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":["id"],"properties":{"id":{"description":"Source identifier. Preserve the supplied type and exact value.","type":["string"],"minLength":1}}},{"required":["play_count"],"properties":{"play_count":{"description":"Optional play count supplied by this operation. Null means unknown.","type":["number"]}}},{"required":["popularity"],"properties":{"popularity":{"description":"Optional popularity supplied by this operation. Null means unknown.","type":["number"]}}},{"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":["uri"],"properties":{"uri":{"description":"Optional uri supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["url"],"properties":{"url":{"description":"Original source URL when supplied.","type":["string"],"minLength":1}}}]}],"x-contract-version":"2026-09-22","x-validation-scope":"Required success payload structure; optional fields and source completeness remain separate.","examples":[{"album":{"album_type":"example","artists":[],"id":"example","image_url":"https://example.com/example","release_date":"2026-09-01T12:00:00Z","title":"example","total_tracks":0,"uri":"example","url":"https://example.com/example"},"artists":[{"id":"example","name":"example","uri":"example","url":"https://example.com/example"}],"duration_ms":0,"explicit":false,"id":"example","kind":"example","play_count":0,"popularity":0,"title":"example","track_number":0,"uri":"example","url":"https://example.com/example"}]}