How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

How do I earn the trust of the developers building on my API?

person_raised_hand Developer Experience Updated August 12, 2026

Short answer

Be predictable, be transparent about pricing and limits and status, communicate change early, honor deprecation commitments, and do not compete with the people building on you.

Trust is the currency the API economy runs on, and it is earned slowly and broken quickly. It is also genuinely political, because the relationship is asymmetric: the consumer commits their architecture to you, and you retain the ability to change the terms.

The things that build it are unglamorous. Put pricing on a public page, in front of the signup, with real numbers. I have trusted providers more for that one act than for almost anything else, because hidden pricing signals that the terms depend on who is asking. Publish rate limits before someone hits one. Run an honest status page. Keep a real change log. Announce breaking changes early with a specific date and reach the affected consumers directly.

The things that destroy it are equally consistent. Quiet sunsets. Terms that change without notice. Rate limits cut retroactively. Building a first-party product that competes with the ecosystem you encouraged. And the classic pattern of extracting as much value from developers as possible and then withdrawing the thing they built on — which does not just cost you those developers, it teaches an entire market that your platform cannot be depended on.

A useful test before any decision that affects consumers: would you be comfortable posting the internal reasoning publicly? If not, you are probably about to spend trust you will not get back.

Go deeper in the guidance

This answer is distilled from the API Evangelist guidance catalog — the long-form treatment of each topic, with its own citations back into sixteen years of writing.

Read the original writing

The posts on apievangelist.com this answer is built on.