explain the API (in README.md)