Trove ran a survey on Hacker News recently asking developers about their biggest pain points for API integration. While OAuth and backwards incompatible changes got their fair share of vitriol, I bet you can guess what the top source of frustration was.
Documentation.
Head over to the survey results, and scroll down to question 6 to see what developers hate about your API. Then ask yourself if maybe your API documentation needs a little help.