only object api

allow user to only pass in an object, with a key of url. maintains backwards compatibility.