Generally, what’s considered a good post has a title that’s a summary and then puts the actual question / suggestion / comment / etc. in the body.
Your title here seems to be asking about APIs. I believe what you’re interested in is the reporting available in Enterprise Edition($$).
For APIs, try what you want to do via the UI. The best way to master the API is to perform the desired action via the UI and eavesdrop to see which calls the UI made to accomplish the action.