update README to contain information about API/Usage - fixes #16

I've provided basic information about the API.
fixes #16