updated with information about the official API