{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://www.monocrawl.com/schemas/spotify/search.json","title":"spotify/search data fields","description":"Optional data supplied by this operation. Null means unknown.","type":"object","properties":{"albums":{"description":"Optional albums 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":{"artist":{"description":"Optional artist supplied by this operation. Null means unknown.","type":["string","null"]},"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"]},"type":{"description":"Optional type supplied by this operation. Null means unknown.","type":["string","null"]},"url":{"description":"Original source URL when supplied.","type":["string","null"]},"year":{"description":"Optional year supplied by this operation. Null means unknown.","type":["number","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"]},"url":{"description":"Original source URL when supplied.","type":["string","null"]},"verified":{"description":"Optional verified supplied by this operation. Null means unknown.","type":["boolean","null"]}},"additionalProperties":true}},"playlists":{"description":"Optional playlists 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":{"description":{"description":"Source description; null or absent means not supplied.","type":["string","null"]},"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}},"tracks":{"description":"Optional tracks 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":{"album":{"description":"Optional album supplied by this operation. Null means unknown.","type":["string","null"]},"artist":{"description":"Optional artist supplied by this operation. Null means unknown.","type":["string","null"]},"duration_ms":{"description":"Optional duration ms supplied by this operation. Null means unknown.","type":["number","null"]},"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}}},"additionalProperties":true,"allOf":[{"anyOf":[{"required":["albums"],"properties":{"albums":{"description":"Optional albums supplied by this operation. Null means unknown.","type":["array"],"items":{"description":"Optional record supplied by this operation. Null means unknown.","type":["object","null"],"properties":{"artist":{"description":"Optional artist supplied by this operation. Null means unknown.","type":["string","null"]},"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"]},"type":{"description":"Optional type supplied by this operation. Null means unknown.","type":["string","null"]},"url":{"description":"Original source URL when supplied.","type":["string","null"]},"year":{"description":"Optional year supplied by this operation. Null means unknown.","type":["number","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"]},"url":{"description":"Original source URL when supplied.","type":["string","null"]},"verified":{"description":"Optional verified supplied by this operation. Null means unknown.","type":["boolean","null"]}},"additionalProperties":true}}}},{"required":["playlists"],"properties":{"playlists":{"description":"Optional playlists supplied by this operation. Null means unknown.","type":["array"],"items":{"description":"Optional record supplied by this operation. Null means unknown.","type":["object","null"],"properties":{"description":{"description":"Source description; null or absent means not supplied.","type":["string","null"]},"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":["tracks"],"properties":{"tracks":{"description":"Optional tracks supplied by this operation. Null means unknown.","type":["array"],"items":{"description":"Optional record supplied by this operation. Null means unknown.","type":["object","null"],"properties":{"album":{"description":"Optional album supplied by this operation. Null means unknown.","type":["string","null"]},"artist":{"description":"Optional artist supplied by this operation. Null means unknown.","type":["string","null"]},"duration_ms":{"description":"Optional duration ms supplied by this operation. Null means unknown.","type":["number","null"]},"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}}}}]}],"x-contract-version":"2026-09-22","x-validation-scope":"Required success payload structure; optional fields and source completeness remain separate.","examples":[{"albums":[{"artist":"example","id":"example","name":"example","type":"example","url":"https://example.com/example","year":0}],"artists":[{"id":"example","name":"example","url":"https://example.com/example","verified":false}],"playlists":[{"description":"example","id":"example","name":"example","url":"https://example.com/example"}],"tracks":[{"album":"example","artist":"example","duration_ms":0,"id":"example","name":"example","url":"https://example.com/example"}]}]}