use default as_json method
add pagination to the html view
add section for API endpoints to the readme