{"id":1229352,"date":"2022-10-19T23:40:38","date_gmt":"2022-10-19T23:40:38","guid":{"rendered":"https:\/\/www.ghanamma.com\/2022\/10\/19\/theneo-wants-to-bring-stripe-like-api-documentation-to-all-developers\/"},"modified":"2022-10-19T23:40:38","modified_gmt":"2022-10-19T23:40:38","slug":"theneo-wants-to-bring-stripe-like-api-documentation-to-all-developers","status":"publish","type":"post","link":"https:\/\/www.ghanamma.com\/2022\/10\/19\/theneo-wants-to-bring-stripe-like-api-documentation-to-all-developers\/","title":{"rendered":"Theneo wants to bring Stripe-like API documentation to all developers \u2022"},"content":{"rendered":"<p><\/p>\n<div>\n<p id=\"speakable-summary\">A new company is taking a leaf out of Stripe\u2019s API playbook with a platform that makes it easy for any company to create clear API documentation, while also allowing non-technical team members to contribute to the process.<\/p>\n<p>Demoing as part of the Battlefield 200 cohort at TC Disrupt this week,  met up with Theneo to find out how they plan to get their slice of the $4.5 billion API management market \u2014 a figure that\u2019s predicted to rise to nearly $14 billion within five years.<\/p>\n<p>APIs, or \u201capplication programming interfaces,\u201d are the glue that hold most modern software together. They\u2019re what allow Uber to offer in-app messaging without building the entire infrastructure themselves from scratch, fitness apps to visualize your running history through maps, and online merchants to support payments powered by Stripe. Internally, companies also create their own APIs to connect all manner of back-end systems and data stores.<\/p>\n<p>In short, APIs are the hidden, often unsung heroes of the modern technological era. But creating an API that\u2019s easy to use and adopt by developers comes with inherent challenges. It isn\u2019t enough to just build the API \u2014 its features, functionality, and deployment instructions need to be recorded and presented in a format that\u2019s easy to follow. Getting the API documentation right is imperative, which is where Theneo is hoping to make its mark.<\/p>\n<div id=\"attachment_2427481\" style=\"width: 1034px\" class=\"wp-caption aligncenter\">\n<p id=\"caption-attachment-2427481\" class=\"wp-caption-text\">Sample API documentation from Theneo <em><strong>Image Credits: Theneo<\/strong><\/em><\/p>\n<\/div>\n<h2>Stripe-like API docs<\/h2>\n<p>Theneo cofounder and CEO Ana Robakidze said that she\u2019d worked on hundreds of APIs in a previous role heading up an engineering team, concluding that quality API documentation is often lacking.<\/p>\n<p>\u201cI personally witnessed the effect API documentation had on our project\u2019s delivery, cost, and efficiency,\u201d Robakidze said. \u201cAs a result, as a team leader, I spent a considerable amount of time and effort searching for a tool that would assist us in creating excellent API documentation \u2014 similar to what Stripe has, as it is considered one of the best in the industry. The problem with most of the tools is that they were either time-consuming or had too many limitations.\u201d<\/p>\n<p>The root of the problem, according to Robakidze, is that developers aren\u2019t necessarily technical writers \u2014 they\u2019d much rather \u201ccreate another API than document it,\u201d she said. Consequently, a lot of internal APIs specifically (i.e. APIs built for connecting a company\u2019s internal systems and apps) either go completely undocumented, or if they are documented, aren\u2019t synchronized and maintained as the API evolves. This issue is compounded as developers come and go within a company, often leading to an unwieldy mess.<\/p>\n<p>\u201cTheneo was created through frustration, with the aim of making high-quality API documentation quick to generate, and simple to maintain,\u201d Robakidze said.<\/p>\n<p>With Theneo, developers connect their GitHub repository or upload their API collection, and Theneo then analyzes everything and delivers the required API documentation. It also offers an AI assistant that uses natural language processing (NLP) to improve the documentation, including automatically describing the different API attributes, which are basically the parts of the API specification that developers need to request, send, and delete data, and so on. So a \u201ccreate customer\u201d object, for example, contains various attributes each with a definition so that the user (i.e. developer) knows exactly what the attribute is for.<\/p>\n<p>\u201cOur AI assistant develops descriptions for these fields, which often take a developer or technical writer a significant amount of time to create, especially when there are thousands of fields in your APIs,\u201d\u00a0Robakidze explained.<\/p>\n<div id=\"attachment_2428029\" style=\"width: 1034px\" class=\"wp-caption aligncenter\"><img decoding=\"async\" aria-describedby=\"caption-attachment-2428029\" loading=\"lazy\" class=\"size-full wp-image-2428029\" src=\"https:\/\/www.ghanamma.com\/gp\/wp-content\/uploads\/2022\/10\/Screenshot-2022-10-19-at-10.26.27.png\" alt=\"\" width=\"1024\" height=\"520\"\/><\/p>\n<p id=\"caption-attachment-2428029\" class=\"wp-caption-text\">Theneo: Sample API document showing fields \/ attribute descriptions <em><strong>Image Credits: Theneo<\/strong><\/em><\/p>\n<\/div>\n<p>While Theneo is designed to automate the process as much as possible, it\u2019s clearly not going to deliver a gift-wrapped API documentation entirely off its own volition \u2014 it acknowledges that developers and other team members will need to fine-tune formats and wording, add more images, or whatever it needs.<\/p>\n<p>\u201cWe analyze the API, parse it, and then return an already well-structured API doc,\u201d Robakidze said. \u201cThe user can then choose whether to add more details, such as images, and different API widgets, add team members so they can collaborate.\u201d<\/p>\n<p>While the engine underpinning Theneo is the same across both internal and external APIs, the company provides additional tooling for the latter, acknowledging that third-party developers appreciate a slicker interface that\u2019s easier to follow. So this basically amounts to a white-label product that can be tailored and branded in accordance with the company\u2019s requirements.<\/p>\n<p>In terms of pricing, Theneo currently has a basic plan that costs around $20 per month per user, rising to $45 per month for unlimited API projects on the business plan. It also offers an enterprise plan that unlocks features such as customized branding and the ability to self-host. It\u2019s also working on a completely free version, though Robakidze said this wasn\u2019t ready for prime time quite yet.<\/p>\n<div id=\"attachment_2427536\" style=\"width: 1034px\" class=\"wp-caption aligncenter\"><img decoding=\"async\" aria-describedby=\"caption-attachment-2427536\" loading=\"lazy\" class=\"size-full wp-image-2427536\" src=\"https:\/\/www.ghanamma.com\/gp\/wp-content\/uploads\/2022\/10\/IMG_20221018_151448-e1666135943241.jpg\" alt=\"\" width=\"1024\" height=\"814\"\/><\/p>\n<p id=\"caption-attachment-2427536\" class=\"wp-caption-text\">Theneo cofounder and CEO Ana Robakidze<\/p>\n<\/div>\n<h2>Funding<\/h2>\n<p>The Y Combinator (YC) graduate has already raised $1.5 million in pre-seed funding since it was founded exactly a year ago, and this week confirmed it\u2019s in the process of raising further funding. And it also unveiled an updated documentation editor, which Robakidze described as something akin to \u201cFigma for APIs,\u201d designed for everyone involved in a software project to contribute, regardless of their technical prowess.<\/p>\n<p>\u201cWe realized that there are multiple players when it comes to building APIs or API docs, and that it is crucial for these users to collaborate,\u201d Robakidze explained. \u201cSimilar to what Figma did with collaboration, our API documentation editor allows users to collaborate, so managers and non-technical members can easily work together on content and produce high-quality documents.\u201d<\/p>\n<p>Robakidze said that the company is pretty much open to working with any size and type of business, and it\u2019s currently working with some 3,000 companies, spanning everything from fintechs and government agencies to agriculture companies.<\/p>\n<p>\u201cOur biggest customers are fintech companies, usually with 20-plus developers,\u201d Robakidze said.<\/p>\n<p>It\u2019s somewhat fitting that Theneo is seeing particular traction within fintech, given that it\u2019s looking to emulate one of the biggest fintech startups to emerge in the past decade. Stripe is well-known for its payment processing API used by startups and big tech firms alike, including Google and Amazon, and the documentation it provides plays a part in why it\u2019s liked by developers.<\/p>\n<p>\u201cOne of the reasons I like working on the Stripe integration is because their API documentation is very well organized, has a very well-thought-out user interface, and generally makes it simple for developers to obtain the information they need to integrate with them,\u201d Robakidze said. \u201cWhen I was working on other Stripe alternatives, it would often take me twice as long because of how challenging it was to browse and locate the necessary API information. Developers adore Stripe\u2019s API documentation, so we wanted to make sure that other businesses and developers could generate the same high-quality documentation.\u201d<\/p>\n<\/div>\n","protected":false},"excerpt":{"rendered":"<p>A new company is taking a leaf out of Stripe\u2019s API playbook with a platform that makes it easy for any company to create clear API documentation, while also allowing non-technical team members to contribute to the process. Demoing as part of the Battlefield 200 cohort at TC Disrupt this week, met up with Theneo [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":1229354,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[21],"tags":[],"class_list":["post-1229352","post","type-post","status-publish","format-standard","has-post-thumbnail","category-celebrity-gossip"],"_links":{"self":[{"href":"https:\/\/www.ghanamma.com\/2022\/wp-json\/wp\/v2\/posts\/1229352","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.ghanamma.com\/2022\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.ghanamma.com\/2022\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.ghanamma.com\/2022\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.ghanamma.com\/2022\/wp-json\/wp\/v2\/comments?post=1229352"}],"version-history":[{"count":0,"href":"https:\/\/www.ghanamma.com\/2022\/wp-json\/wp\/v2\/posts\/1229352\/revisions"}],"wp:attachment":[{"href":"https:\/\/www.ghanamma.com\/2022\/wp-json\/wp\/v2\/media?parent=1229352"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.ghanamma.com\/2022\/wp-json\/wp\/v2\/categories?post=1229352"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.ghanamma.com\/2022\/wp-json\/wp\/v2\/tags?post=1229352"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}