Your API Documentation is Not For Developers Anymore — The Bootstrapped Founder 387


Dear founder,

On April 30th, I'll join Paddle CMO Andrew Davies and my friend KP in a webinar named "From idea to exit: Lessons from SaaS founders who’ve done it" — please join us there, for free.

I had this really interesting experience with a customer of Podscan recently. They reached out saying they were having trouble integrating our API. Now, this wasn’t unusual - we get these requests occasionally. But what happened next completely changed my perspective.

I did what I usually do: recorded a quick Loom video walking through the basics - creating an API key, making that first request, showing how to search for podcasts and get episode listings. Just a simple five-minute guide to get them started.

Their response? “When I watched it, something clicked. You know, I’m not technical at all - I’m just using Claude and ChatGPT and Replit to build some integrations.”

That stopped me in my tracks. Here was someone with no technical background using AI tools to build what turned out to be a pretty sophisticated system: they were planning to download podcast episodes from our API, put them into a vector database, and use an LLM to generate insights and verify information.

The Shifting Landscape

This got me thinking about how dramatically things have changed. Traditionally, API documentation was written by technical people, for technical people. The people reading it were developers who knew exactly what they wanted to do - they were the bridge between their code and our product.

But now? We’re seeing a completely different kind of user. People who might not know what an API key is, who might never have made an HTTP request before, but who can use AI tools to build surprisingly complex solutions.

The Rise of Selfish Software

This reminded me of an article my friend Stefan showed me on every.to called “Selfish Software” with the tagline “Making software can be fun again if you build for the user you’re most eager to please: yourself.”

It’s about people building tiny pieces of non-generalizable software - tools that solve their specific problems without needing to be scalable or sellable. Just software that works for them, for their business, for their projects.

And here’s where it gets interesting: these makers aren’t necessarily developers. They’re people with problems to solve, using AI as their development partner.

The Documentation Challenge

This creates a fascinating challenge for those of us building APIs. Our documentation now needs to serve two masters:

  1. It needs to be technically precise enough for AI tools to generate working code
  2. It needs to be accessible enough for non-technical users to understand the basics

Think about it - we’ve never had to do this before. Previously, our documentation was split: human-readable docs for developers, and machine-readable specs like Swagger or OpenAPI for tools. Now we need something that works for both humans and AI, while being accessible to non-developers.

What We Can Learn from Stripe

Stripe, as usual, is ahead of the curve here. They’ve already started adapting their documentation for this new reality. They offer an LLM.txt file for their entire API docs - essentially a markdown file that helps AI systems understand their API structure. They’ve even added features like “Copy page as markdown” and direct links to open documentation in ChatGPT.

Making Documentation AI-Native

So what does this mean for those of us building APIs? Here are some practical steps we should consider:

First, we need more working examples. AI tools are particularly good at inferring patterns from complete, working code samples. These examples should go from request to response, clearly explained and ready to be adapted.

Second, we need to be more explicit about the basics. We can’t assume knowledge of REST APIs or HTTP requests. Remember, our users might be copying our entire documentation into ChatGPT to generate their integration code.

Finally, we need to think about the experience of non-technical decision makers. Imagine a manager who wants to quickly test if your API fits their needs. They should be able to click a button, have AI generate some test code, and see results immediately.

Looking Forward

This shift represents a fascinating democratization of technical implementation. We’re moving from a world where API integration was exclusively the domain of developers to one where anyone with a problem and access to AI tools can build solutions.

For those of us running software businesses, especially ones with API-first products, this is both a challenge and an opportunity. The challenge is adapting our documentation and onboarding to this new reality. The opportunity? A whole new audience of potential users who previously wouldn’t have considered using our APIs.

I think this is just the beginning. As AI tools become more sophisticated and accessible, we’ll need to keep evolving how we present our technical products to the world. The winners will be those who make their APIs not just powerful, but accessible to this new wave of AI-assisted builders.

We're the podcast database with the best and most real-time API out there. Check out podscan.fm — and tell your friends!

Thank you for reading this week’s essay edition of The Bootstrapped Founder. Did you enjoy it? If so, please spread the word and ​share this issue on Twitter.

If you want to reach tens of thousands of creators, makers, and dreamers, you can ​apply to sponsor ​an episode of this newsletter. Or just reply to this email!

To make sure you keep getting your weekly dose of Bootstrapped Founder, please add arvid@thebootstrappedfounder.com to your address book or whitelist us.

Did someone forward you this issue of The Bootstrapped Founder? ​You can subscribe to it here!​

Want to change which emails you get from The Bootstrapped Founder or unsubscribe for good? No worries, just click this link: ​change email preferences​ or ​unsubscribe​​.

Our postal address: 600 1st Ave, Ste 330 PMB 92768, Seattle, WA 98104-2246

Opt-out of preference-based advertising

Arvid Kahl

Being your own boss isn't easy, but it's worth it. Learn how to build a legacy while being kind and authentic. I want to empower as many entrepreneurs as possible to help themselves (and those they choose to serve).

Read more from Arvid Kahl

Podcast, YouTube, Blog Dear founder, A while ago, I asked my Twitter friends to tell me what the most annoying and most infuriating piece of entrepreneurial advice is that they ever received. And overwhelmingly, “follow your passion” stood out as the one that frustrated them most. I’ve seen this particular piece of advice being given a lot by people who have made it—successful entrepreneurs who found success in the field they’re passionate about. And I may have, from time to time, hinted at...

Podcast, YouTube, Blog Dear founder, Let’s add another one to the series of entrepreneurial advice that just really irritates me. Today, I’m going after “improve 1% every day” — you know, that meme or mantra about making tiny little improvements every day because they supposedly compound into something massive over time. This one is infuriating, and I’ll tell you why: it’s almost impossible to measure. I get the sentiment behind it. Make micro improvements every day, and ultimately they’ll...

Podcast, YouTube, Blog Dear founder, Let’s dive into a piece of entrepreneurial advice that’s highly irritating and very dangerous. Today I want to talk about the one that I get so much: “Don’t give up. Don’t ever give up. Force yourself, grind it out.” This advice is very dangerous because it builds on the founder’s capacity to struggle through challenges, but it uses this for the very wrong reasons. THE BOOTSTRAPPED FOUNDER • EPISODE 432 432: Don't Give Up... Your Assumptions 10:32 MORE...