adding more fields and aliases, improving README's explanation of the return data