Article

Bogomil Shopov
Bogomil Shopov 17 March 2016

How to engage developers to use your API.

There are tens of thousands of API’s available. More to come. Most of the companies though, have troubles engaging developers to use them. So I have decided to share a few thoughts and ideas on how you can do that, based on my experience.

Design your API well

Nobody likes powerful, but not developer-friendly APIs. Follow the “standards” in the area, but innovate a bit to make us (developers) happy and eager to learn more. I will not spend more time here, because I guess you are already building your API if you need the information below. If you are looking for more info on that subject, click here to read an excellent article.

Document your API

If you want other people to use it - document it well. Add examples for the most popular programming languages. Copy/ Paste/ Run is the first step to a great journey.

Do not forget the not-so-trending programming languages at the moment. Target people who explore them - they are the right group to start with.

Eat your own dog-food

Ask your internal developers to use the API. Get the feedback from them and make it better. I am not talking about the developers who wrote the API, they must use it of course. Try to engage other teams within the company (if you have any) to use the API.

Organize an internal Friday APIJam. Sit together in a room for a few hours and do something useful using the technologies you work with - don’t push them to learn new language or technique - just use the API focusing on the value.

Come up with nice awards for the most active participants, get some sweets and drinks (even beer) as well.  Then ask the participants to present their work at the end and listen to their feedback.

Hack your API

Organize hackatons with external groups or jump into such organized by someone else - ask developers to hack the API and to create a small app that will serve theirs needs - then promote the effort and make those developers rockstars by using your PR channels.

The goal is not to test your API (as you do during the internal APIJam event), but to show the value that your API brings to the world. The Call for Action should be something like “use our API to build your own App”.

Create more initiatives like that. Repeat();

Connect

Get in touch with the local developer groups and go the their next meeting with some pizza and beer. Show them your data, ask for their feedback, show them your API, don’t be afraid to ask for help.

Then create a fair process to work with communities around you - what you want from them and what’s in for them.

Discuss

Push the discussion around your API and manage it. Respond to comments immediately, ask for feedback and show how it is implemented. Post your API to reddit, Dzone and other similar sites and get real, honest feedback (together with some trolls, that’s inevitable)

Equilibrium

Treat your community members equally. Sometimes a new member can have a kick-butt idea and if you ignore him/her this can have negative impact overall. Focus on the value!

Partner up

Find partners to help you to get traction. Why don’t you contact your local startup accelerators and do something together to include your awesome API as an requirement for the next call? Does it work? Oh yeah!

Explore

Constantly explore new ways and hacks on how to engage the community, but remember - this must be a fair deal - every part should be happy and equally satisfied. This is your way towards an engaged community.

The best API ever?

No, it's not yours. It's this one :)

Bogomil Shopov
Bogomil Shopov

I am here to answer all of your questions :)

Please login or register to add a comment.

Contribute Now!

Loving our articles? Do you have an insightful post that you want to shout about? Well, you've come to the right place! We are always looking for fresh Doughnuts to be a part of our community.

Popular Articles

See all
Digital Marketing Vs. Traditional Marketing: Which One Is Better?

Digital Marketing Vs. Traditional Marketing: Which One Is Better?

What's the difference between digital marketing and traditional marketing, and why does it matter? The answers may surprise you.

Julie Cave
Julie Cave 14 July 2016
Read more
4 Important Digital Marketing Channels You Should Know About

4 Important Digital Marketing Channels You Should Know About

It goes without saying that a company can't do without digital marketing in today's world.

Digital Doughnut Contributor
Digital Doughnut Contributor 5 November 2014
Read more
How To Write Content That’s Easy To Localize

How To Write Content That’s Easy To Localize

Do you want to know how to reduce costs and get to market faster? Write content that's easy to localize!

David Ost
David Ost 15 June 2017
Read more
The Difference Between AI and Machine Learning

The Difference Between AI and Machine Learning

Artificial Intelligence (AI) and Machine Learning used to be heard when the topic was Big Data Analytics – and maybe in some sci-fi movies- before; but now it is impossible to ignore them with the self-driving cars, knowledge navigators...

Asena Atilla Saunders
Asena Atilla Saunders 15 June 2017
Read more
How To Master Localized SEO

How To Master Localized SEO

When you’re rolling out different language versions of your website, ignore localized SEO at your peril. Failing to consider local keywords, backlinks and social media could cost you valuable site visitors. You’re investing a lot of marketing budget in reaching out to new clients. But fail to get eyes on your website and your efforts will be in vain.

David Ost
David Ost 14 June 2017
Read more