initial inputs and API setup