{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://www.monocrawl.com/schemas/spotify/artist.json","title":"spotify/artist data fields","description":"Optional data supplied by this operation. Null means unknown.","type":"object","properties":{"biography":{"description":"Optional biography supplied by this operation. Null means unknown.","type":["string","null"]},"followers":{"description":"Optional followers supplied by this operation. Null means unknown.","type":["number","null"]},"id":{"description":"Source identifier. Preserve the supplied type and exact value.","type":["string","null"]},"monthly_listeners":{"description":"Optional monthly listeners supplied by this operation. Null means unknown.","type":["number","null"]},"name":{"description":"Optional name supplied by this operation. Null means unknown.","type":["string","null"]},"platform":{"description":"Optional platform supplied by this operation. Null means unknown.","type":["string","null"]},"popularity":{"description":"Optional popularity supplied by this operation. Null means unknown.","type":["number","null"]},"top_cities":{"description":"Optional top cities 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":{"city":{"description":"Optional city supplied by this operation. Null means unknown.","type":["string","null"]},"country":{"description":"Optional country supplied by this operation. Null means unknown.","type":["string","null"]},"listeners":{"description":"Optional listeners supplied by this operation. Null means unknown.","type":["number","null"]}},"additionalProperties":true}},"top_tracks":{"description":"Optional top 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":{"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"]},"playcount":{"description":"Optional playcount supplied by this operation. Null means unknown.","type":["number","null"]},"popularity":{"description":"Optional popularity supplied by this operation. Null means unknown.","type":["number","null"]},"url":{"description":"Original source URL when supplied.","type":["string","null"]}},"additionalProperties":true}},"url":{"description":"Original source URL when supplied.","type":["string","null"]},"verified":{"description":"Optional verified supplied by this operation. Null means unknown.","type":["boolean","null"]},"world_rank":{"description":"Optional world rank supplied by this operation. Null means unknown.","type":["number","null"]}},"additionalProperties":true,"allOf":[{"anyOf":[{"required":["biography"],"properties":{"biography":{"description":"Optional biography supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["followers"],"properties":{"followers":{"description":"Optional followers supplied by this operation. Null means unknown.","type":["number"]}}},{"required":["id"],"properties":{"id":{"description":"Source identifier. Preserve the supplied type and exact value.","type":["string"],"minLength":1}}},{"required":["monthly_listeners"],"properties":{"monthly_listeners":{"description":"Optional monthly listeners supplied by this operation. Null means unknown.","type":["number"]}}},{"required":["name"],"properties":{"name":{"description":"Optional name supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["popularity"],"properties":{"popularity":{"description":"Optional popularity supplied by this operation. Null means unknown.","type":["number"]}}},{"required":["top_cities"],"properties":{"top_cities":{"description":"Optional top cities supplied by this operation. Null means unknown.","type":["array"],"items":{"description":"Optional record supplied by this operation. Null means unknown.","type":["object","null"],"properties":{"city":{"description":"Optional city supplied by this operation. Null means unknown.","type":["string","null"]},"country":{"description":"Optional country supplied by this operation. Null means unknown.","type":["string","null"]},"listeners":{"description":"Optional listeners supplied by this operation. Null means unknown.","type":["number","null"]}},"additionalProperties":true}}}},{"required":["top_tracks"],"properties":{"top_tracks":{"description":"Optional top 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":{"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"]},"playcount":{"description":"Optional playcount supplied by this operation. Null means unknown.","type":["number","null"]},"popularity":{"description":"Optional popularity supplied by this operation. Null means unknown.","type":["number","null"]},"url":{"description":"Original source URL when supplied.","type":["string","null"]}},"additionalProperties":true}}}},{"required":["url"],"properties":{"url":{"description":"Original source URL when supplied.","type":["string"],"minLength":1}}},{"required":["verified"],"properties":{"verified":{"description":"Optional verified supplied by this operation. Null means unknown.","type":["boolean"]}}},{"required":["world_rank"],"properties":{"world_rank":{"description":"Optional world rank supplied by this operation. Null means unknown.","type":["number"]}}}]}],"x-contract-version":"2026-09-22","x-validation-scope":"Required success payload structure; optional fields and source completeness remain separate.","examples":[{"biography":"example","followers":0,"id":"example","monthly_listeners":0,"name":"example","platform":"example","popularity":0,"top_cities":[{"city":"example","country":"example","listeners":0}],"top_tracks":[{"id":"example","name":"example","playcount":0,"popularity":0,"url":"https://example.com/example"}],"url":"https://example.com/example","verified":false,"world_rank":0}]}