What's the best way to include a video in the README?

> To embed a YouTube video, include its URL. The thumbnail renders automatically as an embedded video player. https://docs.apify.com/actors/publishing/actor-readme#videos

So uploading it to youtube is a must? A "unlisted" youtube video will work?

Yes, I think so. As far as I know, unlisted videos work for anyone who has the link.