add to shopping samples
add merchandising API class
Update README.rst
Update README.rst
add error checking to html() class
add filtering to finding sample
store response error codes in an array when processing response.
  The reponse error codes can be accessed by the api.response_codes()
  accessor.
Update README.rst
added errors flag to api initialization issue #23
modify test