updating readme with api examples