use named args. regen the api. start on examples
finish fixing examples. readd get_id_from_url
update README