Twilio, Stripe, Parse, Sendgrid, Mailgun are examples of companies with good documentation.
Generally, I like to see a high-level overview of the API, authentication scheme, endpoints, sample request and response, error code explanations, and sample code coverage in multiple languages. I wrote a blog post on this topic:
http://murtza.org/creating-a-great-developer-experience/
