How (well) does this work cross-device? If I have the Clearspace app on both an iPhone and iPad, does the API aggregate the time as if they were one entity or is it possible to separate the two?
It's up to you. In your Apple devices under Screen time there's a "Share across devices" setting. If that's on, it'll aggregate. If not, it'll just report the screen time from a single entity