massive curl documentation in README.md, also a slew of api fixes