API Documentation and Usability

Developers discuss experiences with various APIs, focusing on documentation quality, usability challenges, development ease, and tools for improvement or exploration.

📉 Falling 0.5x Web Development
4,348
Comments
20
Years Active
5
Top Authors
#9836
Topic ID

Activity Over Time

2007
15
2008
39
2009
81
2010
163
2011
199
2012
349
2013
308
2014
298
2015
228
2016
278
2017
242
2018
161
2019
221
2020
241
2021
261
2022
269
2023
380
2024
294
2025
306
2026
15

Keywords

e.g PHP AI JSON APIFY ApiAxle apitools.com apiaxle.com gist.html REST api apis documentation parse api access service non existent team existent development

Sample Comments

apitman • May 9, 2025 • View on HN

Has anyone played with the API? How is it to develop against?

GSGSGS • Feb 13, 2018 • View on HN

Not that i can see from a surface view, i think documentation can be improved :). Personally like the idea of APIFY, saw it a few months ago. Are you guys hiring ? :D

jshen • Apr 5, 2017 • View on HN

What is an example of a well done API that functions the way you describe?

cobertos • Jan 21, 2024 • View on HN

Why weren't using the APIs fun? Can you talk a little more about what you did with it?

SanjayUttam • Jan 9, 2013 • View on HN

This is going to be super helpful for one of the projects I'm working on...researching APIs is always a bit time consuming due to the huge discrepancy in documentation quality/location/formatting/examples/etc.

alexjray • Jan 14, 2026 • View on HN

Show me the incentive and I can likely guess how hard your API is to use.

dawie • Apr 5, 2007 • View on HN

This is the main reason you have an API. See what people do with your stuff and then do it better!

jonny_eh • Nov 21, 2017 • View on HN

Better API, documentation, and support. It's pretty much that simple.

microstash • Oct 30, 2015 • View on HN

APITools might help (depending on your use case). Haven't used them myself but they gave a pretty good talk a couple months back.https://www.apitools.com

mddanishyusuf • Jan 2, 2020 • View on HN

This is a website about my development experience for APIs. So, I curated them into one place. I hope this will help you. Thanks :)