The API discovers and makes all of Magento's API methods available to you. The
best way to learn how to use the API is to play around with it in a Python shell
and refer back to the Magento API documentation for docs on the usage of specific methods.

Quick IPython Shell

The Magento API is massive and takes effort to grok. If you need to use it in some
production capacity, you'll want to jump into a shell frequently and muck around
with inputs and stare at outputs.

magento-ipython-shell will drop you into an IPython shell that has a variable
bound to a MagentoAPI object that is ready for use.

The shell requires IPython, which is the bee's knees. Install it and get it
working first. Alternately, spin up a Python shell and instantiate the objects
you need. This is just a slightly nicer way to get started mucking around.