- \n
- Common API use cases for ReadMe customers<\/li>\n\n\n\n
- Recommended ReadMe features for your API use case<\/li>\n\n\n\n
- Example customers with a similar API use case already on ReadMe!<\/li>\n<\/ul>\n\n\n\n
For API-first companies…<\/a><\/h2>\n\n\n\n
Your API is the foundation of your business, so users being able to successfully integrate is critical for both customer satisfaction and overall revenue growth.<\/strong> <\/p>\n\n\n\n
In your ReadMe hub, you\u2019ll be documenting your core product \u2014 your API \u2014 which probably means multiple teams will be making updates and turning to your hub as a source of truth: Sales, Support, Product, Engineering, and more. Even more importantly, your developer experience is<\/em> your customer experience, and your developer hub plays a key role in onboarding and implementation.<\/strong><\/p>\n\n\n\n
If you\u2019re an API-first company, we recommend you:<\/p>\n\n\n\n
- \n
- Sync your OAS file<\/a> so that changes to your API update in real time, and set up custom login with variables to populate their API keys directly in your docs<\/li>\n\n\n\n
- Augment your API Reference with Guides<\/a> that cover other aspects of your product experience: dashboard navigation, billing, or other technical topics beyond your API<\/li>\n\n\n\n
- Build out Recipes<\/a> for your most common customer use cases (they\u2019re not only discoverable in your hub, but Sales and Support can share links directly with customers too!)<\/li>\n\n\n\n
- Embed a live chat widget<\/a> or add a clear contact link to reach out to your team, so they can support customers who need help in real time<\/li>\n<\/ul>\n\n\n\n
\ud83d\udd0d Customer spotlight:<\/strong><\/p>\n\n\n\n
See how the team at Scale uses ReadMe to create a seamless API onboarding and support experience for their developers\u00a0here<\/a>!<\/em><\/p>\n\n\n\n
For APIs used to build custom workflows or integrations with your core product…<\/a><\/h2>\n\n\n\n
In this case, your API isn\u2019t your core business, but it\u2019s an important part of how customers work with your SaaS, app, or other product. <\/strong>Customizing internal workflows, syncing data between tools, or building other integrations correlates with product stickiness and revenue retention, so your APIs are still a really important part of your customer experience.<\/p>\n\n\n\n
Developers reading your docs should be able to quickly grasp what\u2019s possible with your APIs and start building, especially since they might not be your core customer. In fact, it’s very likely that they’re just be helping out another team internally, or maybe they\u2019re a new platform partner building an integration their<\/em> customers are asking for. Helping them get started quickly and easily is key, as they may know very little about your product and APIs before landing on your docs.<\/p>\n\n\n\n
In this case, we recommend that you:<\/strong><\/p>\n\n\n\n
- \n
- Enable Try It in your API reference to allow developers to generate code and see what\u2019s happening with their calls in real time, directly from your docs<\/li>\n\n\n\n
- Create a landing page for your developer hub to help orient developers who are new to your docs and add Recipes for your most common custom workflows or integration types<\/li>\n\n\n\n
- Use the glossary feature to call out and define important terms or phrases that may be native to your product, API, or documentation<\/li>\n<\/ul>\n\n\n\n
\ud83d\udd0e Customer spotlight:<\/strong><\/p>\n\n\n\n
Check out how Miro<\/a> uses ReadMe to build out their developer hub to enable teams around the world to integrate with their APIs!<\/em><\/p>\n\n\n\n
![\"Screenshot](\"https:\/\/readme.com\/resources\/wp-content\/uploads\/2024\/06\/image-51-1024x496.png\")
<\/figure>\n\n\n\nFor limited access or private APIs<\/a><\/h2>\n\n\n\n
If you limit access to your APIs to only certain customers, partners, or employees, it\u2019s critical that you have control over who can see your developer hub. <\/strong>This is particularly common in highly regulated industries like healthcare or finance. For companies in these industries (and many others), data privacy is paramount and where you have to be extra careful about the external developers who can safely access your API and documentation.<\/p>\n\n\n\n
If you need to limit access to your API:<\/strong><\/p>\n\n\n\n
- \n
- Our Enterprise plan<\/a> allows you to enable login protection so that you can protect the privacy of your API and documentation<\/li>\n\n\n\n
- With our Enterprise plan you can also decide whether your docs are public, hidden, or log-in protected<\/li>\n\n\n\n
- Learn more about setting up Access Control and the various ways to authenticate your users here<\/li>\n<\/ul>\n\n\n\n
\ud83d\udd0e We can\u2019t highlight ReadMe customers with limited access APIs because, well, those hubs are private! But if you have any questions or want to learn more, don\u2019t hesitate to reach out to our Enterprise team<\/a>.<\/em><\/p>\n\n\n\n
If you have multiple products but want to house them under one developer hub…<\/a><\/h2>\n\n\n\n
If your company has multiple products or multiple APIs, then it makes sense to collectively group them in one developer hub. This keeps documentation for each one separate and organized, while sharing search, navigation, branding, and a global landing page that feel cohesive and make it easy for developers to find what they\u2019re looking for across all your offerings.<\/p>\n\n\n\n
If you have multiple products with APIs, our best solution for you is ReadMe\u2019s Enterprise plan<\/a>. With our Enterprise solution, you can easily manage multiple projects \u2014 each with their own API reference section \u2014 in one easy-to-maintain hub.<\/p>\n\n\n\n
This way, you can keep your APIs maintained in separate projects but enjoy all the benefits of:<\/strong><\/p>\n\n\n\n
- \n
- A global home for your developer hub, including unified navigation and search across all of your projects, and a customizable landing page to welcome developers to your hub<\/li>\n\n\n\n
- Customizable design that allows you to unify the look and feel across all of your docs<\/li>\n\n\n\n
- Comprehensive admin controls that allow you to easily manage projects, permission levels, and content across all of your projects\u2019 documentation<\/li>\n<\/ul>\n\n\n\n
\ud83d\udd0e Customer spotlight:<\/strong><\/p>\n\n\n\n
Enterprise customers like Akamai<\/a> and Dolby<\/a> use ReadMe to power personalized and interactive developer experiences for the many developers using their APIs!<\/em><\/p>\n\n\n\n
![\"Screenshot](\"https:\/\/readme.com\/resources\/wp-content\/uploads\/2024\/06\/image-52-1024x559.png\")
<\/figure>\n\n\n\nDon\u2019t have an API?<\/a><\/h2>\n\n\n\n
While ReadMe\u2019s bread \ud83e\udd56 and butter \ud83e\uddc8 is in helping you transform your API documentation into an interactive developer hub, you can still use ReadMe even if you don\u2019t have an API.<\/p>\n\n\n\n
At its core, ReadMe offers the best documentation solution for allowing teams to collaborate on publishing technical content, especially if your product has a complex implementation or caters to engineers. And by starting out with your technical docs in ReadMe, if \u2014 and when \u2014 you build an API in the future, you\u2019ve already got a head start \ud83d\ude09<\/p>\n","protected":false},"excerpt":{"rendered":"
APIs come in all shapes and sizes and while ReadMe is a great documentation solution for whatever kind of API you have, we\u2019ve created this page to help you get the most out of the right features depending on your API\u2019s use case. \u2728 Read on for: For API-first companies… Your API is the foundation of […]<\/p>\n","protected":false},"author":7,"featured_media":2907,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"content-type":"","inline_featured_image":false,"footnotes":""},"categories":[35,24],"tags":[42,15,45],"ppma_author":[50],"class_list":["post-2834","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-readme-101","category-readme-journey","tag-api-tips","tag-behind-the-docs","tag-developer-experience"],"acf":[],"yoast_head":"\n
Use Cases: How to Make ReadMe Work for You - ReadMe: Resource Library<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/readme.com\/resources\/use-cases-how-to-make-readme-work-for-you\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Use Cases: How to Make ReadMe Work for You - ReadMe: Resource Library\" \/>\n<meta property=\"og:description\" content=\"APIs come in all shapes and sizes and while ReadMe is a great documentation solution for whatever kind of API you have, we\u2019ve created this page to help you get the most out of the right features depending on your API\u2019s use case. \u2728 Read on for: For API-first companies… Your API is the foundation of […]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/readme.com\/resources\/use-cases-how-to-make-readme-work-for-you\" \/>\n<meta property=\"og:site_name\" content=\"ReadMe: Resource Library\" \/>\n<meta property=\"article:published_time\" content=\"2024-06-16T22:04:23+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2025-12-17T01:34:51+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/readme.com\/resources\/wp-content\/uploads\/2024\/06\/How-to-Make-ReadMe-Work-for-You.png\" \/>\n\t<meta property=\"og:image:width\" content=\"200\" \/>\n\t<meta property=\"og:image:height\" content=\"200\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"author\" content=\"Rachel Kalt\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Rachel Kalt\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"6 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/readme.com\/resources\/use-cases-how-to-make-readme-work-for-you\",\"url\":\"https:\/\/readme.com\/resources\/use-cases-how-to-make-readme-work-for-you\",\"name\":\"Use Cases: How to Make ReadMe Work for You - ReadMe: Resource Library\",\"isPartOf\":{\"@id\":\"https:\/\/readme.com\/resources\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/readme.com\/resources\/use-cases-how-to-make-readme-work-for-you#primaryimage\"},\"image\":{\"@id\":\"https:\/\/readme.com\/resources\/use-cases-how-to-make-readme-work-for-you#primaryimage\"},\"thumbnailUrl\":\"https:\/\/readme.com\/resources\/wp-content\/uploads\/2024\/06\/How-to-Make-ReadMe-Work-for-You.png\",\"datePublished\":\"2024-06-16T22:04:23+00:00\",\"dateModified\":\"2025-12-17T01:34:51+00:00\",\"author\":{\"@id\":\"https:\/\/readme.com\/resources\/#\/schema\/person\/63cf4ae45ef03d57e84b38edee5d8713\"},\"breadcrumb\":{\"@id\":\"https:\/\/readme.com\/resources\/use-cases-how-to-make-readme-work-for-you#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/readme.com\/resources\/use-cases-how-to-make-readme-work-for-you\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/readme.com\/resources\/use-cases-how-to-make-readme-work-for-you#primaryimage\",\"url\":\"https:\/\/readme.com\/resources\/wp-content\/uploads\/2024\/06\/How-to-Make-ReadMe-Work-for-You.png\",\"contentUrl\":\"https:\/\/readme.com\/resources\/wp-content\/uploads\/2024\/06\/How-to-Make-ReadMe-Work-for-You.png\",\"width\":200,\"height\":200},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/readme.com\/resources\/use-cases-how-to-make-readme-work-for-you#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/readme.com\/resources\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Use Cases: How to Make ReadMe Work for You\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/readme.com\/resources\/#website\",\"url\":\"https:\/\/readme.com\/resources\/\",\"name\":\"ReadMe: Resource Library\",\"description\":\"Making API documentation better for everyone\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/readme.com\/resources\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\/\/readme.com\/resources\/#\/schema\/person\/63cf4ae45ef03d57e84b38edee5d8713\",\"name\":\"Rachel Kalt\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/readme.com\/resources\/#\/schema\/person\/image\/7e225d78cc4acf17144b893c7c2076f0\",\"url\":\"https:\/\/readme.com\/resources\/wp-content\/uploads\/2024\/06\/rachelkalt.jpeg\",\"contentUrl\":\"https:\/\/readme.com\/resources\/wp-content\/uploads\/2024\/06\/rachelkalt.jpeg\",\"caption\":\"Rachel Kalt\"},\"description\":\"A NY native, Ray spent 10 years in the Bay, followed by a year in NYC, only to realize that it was time to see what other places call to her, her partner, & their dog, Theo. Before product marketing, Ray spent nearly a decade in design agencies, and even longer in restaurants. She\u2019s a lifelong dancer, avid home cook, & reader.\",\"url\":\"https:\/\/readme.com\/resources\/author\/rachel\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Use Cases: How to Make ReadMe Work for You - ReadMe: Resource Library","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/readme.com\/resources\/use-cases-how-to-make-readme-work-for-you","og_locale":"en_US","og_type":"article","og_title":"Use Cases: How to Make ReadMe Work for You - ReadMe: Resource Library","og_description":"APIs come in all shapes and sizes and while ReadMe is a great documentation solution for whatever kind of API you have, we\u2019ve created this page to help you get the most out of the right features depending on your API\u2019s use case. \u2728 Read on for: For API-first companies… Your API is the foundation of […]","og_url":"https:\/\/readme.com\/resources\/use-cases-how-to-make-readme-work-for-you","og_site_name":"ReadMe: Resource Library","article_published_time":"2024-06-16T22:04:23+00:00","article_modified_time":"2025-12-17T01:34:51+00:00","og_image":[{"width":200,"height":200,"url":"https:\/\/readme.com\/resources\/wp-content\/uploads\/2024\/06\/How-to-Make-ReadMe-Work-for-You.png","type":"image\/png"}],"author":"Rachel Kalt","twitter_card":"summary_large_image","twitter_misc":{"Written by":"Rachel Kalt","Est. reading time":"6 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/readme.com\/resources\/use-cases-how-to-make-readme-work-for-you","url":"https:\/\/readme.com\/resources\/use-cases-how-to-make-readme-work-for-you","name":"Use Cases: How to Make ReadMe Work for You - ReadMe: Resource Library","isPartOf":{"@id":"https:\/\/readme.com\/resources\/#website"},"primaryImageOfPage":{"@id":"https:\/\/readme.com\/resources\/use-cases-how-to-make-readme-work-for-you#primaryimage"},"image":{"@id":"https:\/\/readme.com\/resources\/use-cases-how-to-make-readme-work-for-you#primaryimage"},"thumbnailUrl":"https:\/\/readme.com\/resources\/wp-content\/uploads\/2024\/06\/How-to-Make-ReadMe-Work-for-You.png","datePublished":"2024-06-16T22:04:23+00:00","dateModified":"2025-12-17T01:34:51+00:00","author":{"@id":"https:\/\/readme.com\/resources\/#\/schema\/person\/63cf4ae45ef03d57e84b38edee5d8713"},"breadcrumb":{"@id":"https:\/\/readme.com\/resources\/use-cases-how-to-make-readme-work-for-you#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/readme.com\/resources\/use-cases-how-to-make-readme-work-for-you"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/readme.com\/resources\/use-cases-how-to-make-readme-work-for-you#primaryimage","url":"https:\/\/readme.com\/resources\/wp-content\/uploads\/2024\/06\/How-to-Make-ReadMe-Work-for-You.png","contentUrl":"https:\/\/readme.com\/resources\/wp-content\/uploads\/2024\/06\/How-to-Make-ReadMe-Work-for-You.png","width":200,"height":200},{"@type":"BreadcrumbList","@id":"https:\/\/readme.com\/resources\/use-cases-how-to-make-readme-work-for-you#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/readme.com\/resources\/"},{"@type":"ListItem","position":2,"name":"Use Cases: How to Make ReadMe Work for You"}]},{"@type":"WebSite","@id":"https:\/\/readme.com\/resources\/#website","url":"https:\/\/readme.com\/resources\/","name":"ReadMe: Resource Library","description":"Making API documentation better for everyone","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/readme.com\/resources\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/readme.com\/resources\/#\/schema\/person\/63cf4ae45ef03d57e84b38edee5d8713","name":"Rachel Kalt","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/readme.com\/resources\/#\/schema\/person\/image\/7e225d78cc4acf17144b893c7c2076f0","url":"https:\/\/readme.com\/resources\/wp-content\/uploads\/2024\/06\/rachelkalt.jpeg","contentUrl":"https:\/\/readme.com\/resources\/wp-content\/uploads\/2024\/06\/rachelkalt.jpeg","caption":"Rachel Kalt"},"description":"A NY native, Ray spent 10 years in the Bay, followed by a year in NYC, only to realize that it was time to see what other places call to her, her partner, & their dog, Theo. Before product marketing, Ray spent nearly a decade in design agencies, and even longer in restaurants. She\u2019s a lifelong dancer, avid home cook, & reader.","url":"https:\/\/readme.com\/resources\/author\/rachel"}]}},"authors":[{"term_id":50,"user_id":7,"is_guest":0,"slug":"rachel","display_name":"Rachel Kalt","avatar_url":{"url":"https:\/\/readme.com\/resources\/wp-content\/uploads\/2024\/06\/rachelkalt.jpeg","url2x":"https:\/\/readme.com\/resources\/wp-content\/uploads\/2024\/06\/rachelkalt.jpeg"},"first_name":"Rachel","last_name":"Kalt","position":"Product Marketing Manager","slogan":"","description":"A NY native, Ray spent 10 years in the Bay, followed by a year in NYC, only to realize that it was time to see what other places call to her, her partner, & their dog, Theo. Before product marketing, Ray spent nearly a decade in design agencies, and even longer in restaurants. She\u2019s a lifelong dancer, avid home cook, & reader."}],"_links":{"self":[{"href":"https:\/\/readme.com\/resources\/wp-json\/wp\/v2\/posts\/2834","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/readme.com\/resources\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/readme.com\/resources\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/readme.com\/resources\/wp-json\/wp\/v2\/users\/7"}],"replies":[{"embeddable":true,"href":"https:\/\/readme.com\/resources\/wp-json\/wp\/v2\/comments?post=2834"}],"version-history":[{"count":0,"href":"https:\/\/readme.com\/resources\/wp-json\/wp\/v2\/posts\/2834\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/readme.com\/resources\/wp-json\/wp\/v2\/media\/2907"}],"wp:attachment":[{"href":"https:\/\/readme.com\/resources\/wp-json\/wp\/v2\/media?parent=2834"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/readme.com\/resources\/wp-json\/wp\/v2\/categories?post=2834"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/readme.com\/resources\/wp-json\/wp\/v2\/tags?post=2834"},{"taxonomy":"author","embeddable":true,"href":"https:\/\/readme.com\/resources\/wp-json\/wp\/v2\/ppma_author?post=2834"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
- Our Enterprise plan<\/a> allows you to enable login protection so that you can protect the privacy of your API and documentation<\/li>\n\n\n\n
- Augment your API Reference with Guides<\/a> that cover other aspects of your product experience: dashboard navigation, billing, or other technical topics beyond your API<\/li>\n\n\n\n
- Sync your OAS file<\/a> so that changes to your API update in real time, and set up custom login with variables to populate their API keys directly in your docs<\/li>\n\n\n\n