State of API developer portals

A detailed review of top 100 API companies about how they expose, manage and monetize their APIs.

Alexandre Airvault

State of API developer portals

A detailed review of top 100 API companies about how they expose, manage and monetize their APIs.

Alexandre Airvault

Definitions

  1. Direct Traffic:
    Direct traffic refers to visits to a website that come directly from a user typing the URL into their browser, clicking on a bookmark, or clicking on a link from an email or other document that doesn't contain referral information.
  2. Search:
    Search traffic refers to visits that come to a website as a result of someone searching for something using a search engine like Google, Bing, Yahoo, etc. These visits are driven by the user's specific search query and the results that the search engine returns.
  3. Referral:
    Referral traffic refers to visits to a website that come from clicking on a link on another website. This is also known as "referred traffic." The referral information is passed along through the use of a "referrer" header in the HTTP request.
  4. Paid:
    Paid traffic refers to visits to a website that are the result of an advertisement. This could be a pay-per-click (PPC) ad, a display ad, or some other type of paid advertising. Paid traffic is driven by an advertiser's budget and advertising strategy.
  5. Social:
    Social traffic refers to visits to a website that come from social media platforms like Facebook, Twitter, Instagram, etc. This traffic is driven by social media users who click on links shared on their social media feeds.
  6. Data Companies:
    Data companies selling data products. The data can be historical or live. An example is electricity maps selling electricity CO2 data.
  7. Service companies:
    Service companies are selling services via an API. They allow end users to perform some actions. An example is Yousign providing online signature service through an API.
  8. Processing companies:
    Processing companies are selling the result of data processing. A perfect example is Open AI.
  9. API versioning:
    API versioning is important because it allows developers to make changes to the API without affecting existing clients, while also allowing new clients to access new functionality. This helps to ensure backwards compatibility and allows developers to experiment with new features and functionality without affecting the stability of the API. There are several strategies for versioning APIs, including URL versioning and header versioning.
  10. PAYG:
    Pay-as-you-go (PAYG) is a business model in which customers only pay for the services or products they actually use, rather than paying a flat fee or subscribing to a package of services. This pricing model is based on usage and provides customers with more control over their spending, as they can easily adjust their usage to stay within budget.
  11. API reference:
    Reference manual containing all the information required to work with the API, with details about the functions, classes, return types, arguments and more, supported by tutorials and examples.
  12. Payload examples (JSON):
    The request payload is information in a data block that clients send to the server in the body of an HTTP POST, PUT or PATCH message that contains important information about the request. The Payload can be sent or received in various formats, including JSON
  13. Mobile version:
    Version of the developer portal is available on mobile for all pages.
  14. Search bar:
    A rectangular field on screen that accepts typed-in text in order to look up something or launch a search
  15. Errors description:
    An error that occurs with a code error associated. With the error code is associated a description of the reasons of the error.
  16. Customer implementation examples:
    Those a in production examples of customers using the API live with feedback from developers or business owners about the value of the API being used.
Previous chapter: 7/8
How to share the report

Build your API portal with Blobr

Start building or get in touch with our sales team.