State of the API Report 2020 - Key Insights
Tags: restapis, softwaredevelopment, api, apidevelopment
Published: 2020-11-27 08:11:33

---
title: State of the API Report 2020 - Key Insights
published: true
date: 2020-11-25 15:25:40 UTC
tags: RESTAPIs,SoftwareDevelopment,API,APIdevelopment
canonical_url: https://linx.software/state-of-the-api-report-2020/
cover_image: https://dev-to-uploads.s3.amazonaws.com/i/rgco1jwlgg7m75o6xzya.jpg
---

### Key takeaways from the annual Postman and Smartbear reports

Every year, [Postman](https://www.postman.com/) surveys industry members to get a picture of the API industry — to understand who is working with APIs, how they are getting their work done, and where they see the industry going. More than 13,500 developers, testers, executives, and others took the 2020 survey and provided insights on everything from how they spend their time to what they see as the biggest issues and opportunities for APIs.

This year’s [Smartbear](https://smartbear.com/) survey contained 52 questions and collected a total of 3,536 responses. The primary audience for the survey were end users of the open source and commercial versions of the Swagger, SoapUI and ReadyAPI tools. The findings presented are based on the completed responses from over 1,500 developers, architects, QA professionals, operations engineers, and product leaders from more than 16 different industries globally.

In this article we will look at two annual State of the API reports, both respected within the industry, to gain insight into the following:

- What do users require of APIs?
- What are the obstacles to consuming APIs?
- What are the obstacles to producing APIs?
- What are the obstacles to producing API documentation?

## API Requirements

The focus here is on respondents’ expectations and needs of APIs.

When respondents were asked in the _Postman_ survey what factors are considered _before_ integrating with an API, **reliability was the most important factor** , at 71.6%, followed closely by security, performance, and documentation, which all came in slightly less (but all above 70%).

![](https://lh4.googleusercontent.com/Cn1eWyzn79InDkOgxpqMWneiKMhFXTSvM9DjrDGNU3uMby4pHHq5cWQeQDTQTvJcsak3GDMobOAlUi5jOA3SZCiAwJP56UVOKIPE0bCXiY9TwcWYE24tK1i3CeA8LGyWnFP2aoaL)

In the _Smartbear_ survey respondents were asked to list the top three most important characteristics that they need in an API. **Ease of use** (68%), accurate and **detailed documentation** (63%), and **responsiveness / performance** (47%) were the characteristics listed most by respondents.

![](https://lh5.googleusercontent.com/9JrF5PKBz0q9Xd5Rjed5ZNSXADeK0apJnwFu98iWDGON81uKskoYncRRSlUmB0N66Qsfs4s4I8llX3pj8Wi7ow7v-r5vjS58VZRrNy4igGO35z0fMn7Ov_Prul6Pab0ttktT0A5i)

**Key Takeaway**

Respondents’ indication of the importance of **reliability and performance** is no surprise. What stands out is the high level of importance assigned to documentation. The implication is that, without the availability of accurate and detailed documentation, prospective consumers of an API might opt for another API instead.

## Obstacles to Consuming APIs

The focus here is on respondents’ actual experience of consuming APIs.

The _Postman_ survey asked respondents about the biggest obstacle to consuming APIs: **lack of documentation** is seen as the biggest obstacle to consuming APIs (54.3%), by a very wide margin. Other top obstacles to consuming APIs are lack of knowledge, complexity, and lack of time, all cited by a little over one-third of respondents.

![](https://lh3.googleusercontent.com/BQQFo1kniEQIA5OiBCpCY7zc1w4tS6GGa58yvYG2_gtH0Fjl8XXLYxMn7aHexNtWORjWMme-RqTw69qrbJcoSkkWNze1ObW7NmwkoaPuwwxSc5tN5bjcyN9kegGtLmUiCbxSeU-A)

When _Smartbear_ asked about the biggest obstacles to ensuring API quality, **limited time** due to workload (52%), increasing **demands for speed of delivery (**45%), and **lack of skills** or experience (34%) were indicated most by respondents.

![](https://lh3.googleusercontent.com/l331tDUVN47ti6bl19iUdTAAVpoBHqDa4RJzD7IzzmLrZISf8DoAon9ejZq2lH4vBnxGc8LRWfQ26_ZCZwmvM39gMCIwrdre_vN0_pX_9qCmnG1fcOu41NlBi5Ygqwtm85_GQhS5)

**Key Takeaway**

Respondents from both surveys indicated that **lack of time** is the biggest obstacle in producing APIs. Lack of resources, knowledge and skills were also identified as significant obstacles. The implication is that developers producing APIs [need tools](https://dev.to/linxsoftware/28-tools-to-design-build-and-host-your-api-12ce) to help them produce APIs faster and easier.

## Obstacles to Producing API Documentation

_Smartbear’s_ question about the biggest obstacles to ensuring API documentation quality resulted in most respondents (64%) indicating that **limited time due to workload** is their biggest obstacle, followed by documentation being out of sync with the actual API implementation (47%) and lack of personnel (29%).

![](https://lh5.googleusercontent.com/Hbp9WQsHZtRAG9TIkuKS9gyFuu8DjLL20QE0GbCq3onj30AQdoo66JpJVmr29C8bQdJvLuGljdfh0i6M2BVepxSpJBLVdb8pBicE6xT4OL8jTayJPcuObyf-QE1tgRl1oI1v0XIz)

**Key Takeaway**

As with producing APIs, the biggest obstacle to producing API documentation is **lack of time.** The implication is that either more people are required to focus on documentation, or [better tools](https://linx.software/6-tools-for-api-design-development-and-testing/)are needed to assist development teams in producing API documentation.

* * *

## Low-code: The Future of APIs?

The reports indicated that API documentation is viewed as an important requirement for choosing an API to integrate to. Additionally,  producers of APIs have identified lack of time (and resources) as the biggest obstacle to completing an API project. Tag this alongside the elimination of rewriting authentication code, parsing logic, and the other mundane aspects of writing code that integrates with an external service, low code is certainly [something to consider.](https://dev.to/linxsoftware/building-an-api-consider-low-code-ga4)  
  
Low code solve many of today’s IT concerns. Being a professional software developer is not about writing a programming language, and writing code is not the most crucial part of the job. Software development is mostly about the stack, the platforms, data sources, databases, network layers, APIs and security mechanisms and procedures that you use to build client-server software solutions.

The job of a low code platform is to take care of the stack so that you can get on with the logic. If a platform or tool allowed you to substantially reduce engineering time and dollars spent and still produce a high-quality API, would you use it?

The post [State of the API, 2020](https://linx.software/state-of-the-api-report-2020/) appeared first on [Linx](https://linx.software).