Best Findability of Products in a DevPortal

What are the examples of findability in developer portals?

There is rarely a “one shoe fits all” solution. Information architecture can vary from customer to customer in terms of the complexity of the products being offered to the simplicity of APIs that stand out from each other. 

Setting up a developer portal is not just about sharing a bucket of building blocks. All the blocks have to be available, accessible, findable and discoverable. Companies that do this well give the developer portal users a structure: there are examples, the documentation is there where it is expected, troubleshooting is easy. In short: the overall experience is organised and in place.

A landing page with entry points for the main audiences, a catalog, a basic search, a faceted search, and suggestive discoverability are all examples of ways in which an API consumer can find your APIs.

 

Award Criteria

Questions to ask:

  • Are there filtering options or is there relevant categorization and an easy entry point to the service catalog?

  • Is the experience visually appealing and easy to follow?

  • Are you reducing the friction to your user's journey to finding what they are looking for?

  • How discoverable are the products in your devportal?

  • How do you get people to know about an API for the first time?

  • How do you organize your catalog to allow for better discoverability?

As this award focuses on the findability of products, nominees for this category usually have more than a few API product offerings.

Read more about the anti-patterns of developer portals such as the API Freezer (being an obstacle for good findability and discoverability) on the Pronovix blog.

Nominees in this Category

Acquia

Acquia Developer Portal (2023)

Nationwide Insurance

Nationwide Partner Portal (2023)

FactSet

FactSet Developer (2023)

Mercedes-Benz AG

Mercedes-Benz / developers (2023)

Casper

Casper Developer Portal (2023)

Network International

Network International Developer Hub (2023)

FedEx

FedEx Developer Portal (2023)

Canopy Servicing

Canopy Docs (2023)

Nexio

Nexio Developer Portal (2023)

PandaDoc

PandaDoc for Developers (2023)

Tapdata

Tapdata Cloud (2023)

NewDay

NewDay Docs (2023)

Equifax, Inc

Equifax Developer API Portal (2023)

Novopayment

Novopayment Developer Hub (2023)

PossibleNOW

MyPreferences Developer Portal (2023)

Mapbox

Mapbox Docs

Air France-KLM

Air France-KLM Developer Portal (2023)

Cloudinary

Cloudinary Docs (2023)

PaymentsHub by North American Bancard

Payments Hub Developer Portal (2023)

Anvil

Anvil API Suite (2023)

ABN Amro Bank N.V.

ABN AMRO Developer Portal (2023)

Global Payments Inc.

Global Payments Developer Portal (2023)

iFood

iFood Developer (2023)

BigCommerce

BigCommerce Developer Center (2023)

Deutsche Börse Group

Deutsche Börse Group API Platform (2023)