API documentation is essentially a user instructions/help guidebook for an API. It tells consumers how to use the API, what the API does, expected input, expected output, relevant status codes and how to resolve errors should they occur.
Good API documentation is crucial because:
- People will find it easier to use the API, leading to better growth and adoption
- Better product maintenance
- Less time and spent on supporting new users of the API
Changhoon's blog 