Improve API doc a bit
Add offers API doc