Quick question: is the embed structure wrong on purpose?

what do you mean?

I'm most likely missing something but I would have expected the embedded video to be within embed -> video (just like images in the other example). Instead right now all properties of the video struct are just one level up right within embed.

at a guess, I think images are like that because it’s an array

there’s no reason the properties of the video can’t be at the top level. is that causing you issues?

a little, yeah. It's because embed is polymorphic and I parse its (nested) content based on the $type within embed