Video is one of the most underused channels in API evangelism, and it occupies a distinctive place in the storyteller’s toolbox because it shows developers how something works rather than just telling them. There’s a category of understanding that text struggles to convey and that a three-minute screencast delivers instantly — watching someone make the first call, see the response, and wire it into a working app communicates more than pages of prose. I’ve counted video among the building blocks of evangelism since the early days, recommending that API providers establish a YouTube channel for their developer community as a core piece of their outreach. Video isn’t a replacement for documentation or blog posts; it’s a complementary channel that reaches people who learn by watching, that captures the talks and demos that would otherwise evaporate, and that meets developers on the platforms where they already spend their time.
The YouTube-channel recommendation is one I’ve made consistently, because a video channel is infrastructure, not a one-off. I wrote in 2011 about establishing a YouTube channel for your API community, framing it as a building block — a persistent, growing library of video content that serves your developers over time. A single video is useful; a channel is an asset that compounds. As the API space expanded, I noted how the sources of knowledge multiplied across new YouTube and audio channels, because the community’s appetite for video and audio learning kept growing. The channel becomes the home for your walkthroughs, your conference talks, your demos, and your tutorials — a searchable, embeddable, persistent resource that developers return to. Building that channel deliberately, and feeding it consistently, is how video moves from an occasional afterthought to a genuine pillar of your evangelism program.
The walkthrough and tutorial use case is where video earns its keep, and I’ve pointed to it specifically. I wrote in 2016 about providing video walk-throughs on YouTube for your API or API provider services, because the screen-recorded walkthrough is video’s killer application in the API world. Watching someone navigate the portal, generate a key, make the first call, and interpret the response collapses the time-to-first-success for a new developer dramatically. These walkthroughs also do double duty as SEO and discovery surface — developers search YouTube for “how to use X API,” and a good walkthrough video meets them right at the moment of need. The hands-on, show-me-don’t-tell-me quality of video makes it uniquely effective for onboarding, where the goal is getting a developer from zero to a working integration as fast as possible. A well-made walkthrough can do more for activation than any amount of written documentation, because it removes the ambiguity that text inevitably leaves.
Video also preserves the ephemeral, and that’s a contribution to evangelism that’s easy to overlook. Conference talks, panels, and demos happen once and then vanish unless someone records them — and I’ve long argued for capturing them. I published video from conference panels and talks, like the hypermedia panel from a gathering in Detroit, precisely because the knowledge shared in those rooms deserves a life beyond the people who happened to be present. Recorded talks extend the reach of every event from the few hundred in the room to the thousands who watch later. Internal evangelism benefits too — I wrote about demo Fridays as an internal evangelism practice, and video lets those internal demos be recorded, shared, and preserved across a distributed organization. Video turns the one-time, in-person moment into a durable, reusable asset, which is exactly what evangelism needs: stories that keep working long after they’re first told.
Video fits into the broader hands-on storytelling approach I’ve championed, and it works best as one channel among several rather than in isolation. I wrote in 2021 about a blueprint for hands-on API storytelling that combined blog posts, images, video, and interactive workspaces — because the most effective evangelism uses multiple channels reinforcing each other. Video shows the thing in motion; the blog post explains the why and provides the searchable text; the interactive workspace lets the developer try it themselves; the images anchor it visually. Video is strongest when it’s part of this multi-channel story, not when it’s expected to carry the whole load. The developer who watches the walkthrough, reads the accompanying post, and then runs the collection themselves has learned the API three different ways, and that reinforcement is what makes the learning stick. Video is a powerful channel, but it’s a channel in an orchestra, not a soloist.
Where I land on video is that it’s a high-leverage, persistently underused evangelism channel that deserves more deliberate investment than most API providers give it. The barriers have never been lower — screen recording is trivial, hosting is free, and developers actively search video platforms for help — yet most API programs still treat video as an occasional extra rather than a core building block. The YouTube channel as infrastructure, the walkthrough as onboarding accelerator, the recording that preserves the ephemeral talk, the role within a multi-channel hands-on story — they all point to video as a channel that punches above its weight when it’s done with intention. Video shows developers how, in a way that text can only approximate, and that show-me quality makes it uniquely suited to the moments that matter most in evangelism: the first call, the first integration, the first success. The providers who build a real video practice — a fed channel, consistent walkthroughs, recorded talks, video woven into the larger story — reach developers that text alone never will, and they do it at the exact moments when a developer most needs to see, not just read, how the thing works.
References
- A YouTube Channel For Your API Community
- Internal API Evangelism: Demo Fridays
- Facebook Launches A New Video Channel For Developers
- Video From The Hypermedia Panel At APICraft In Detroit Last Month
- As API Space Expands, So Do The Sources Of Knowledge: New YouTube And SoundCloud Channels
- Providing Video Walk-Throughs On YouTube For Your API Or API Provider Services
- A Blueprint For Hands-On API Storytelling
