improved list extraction and API interface