Programmatic api readme updates

Addresses #65. I think it might be a good idea to remove the `args` object first from the code because it's unused and makes for an awkward explanation in the documentation.