Improve API call descriptions

Added more explicit descriptions about API calls that return JSON objects.
Fixed some ambiguous wording.
Fixed some icky spacing.