My reply will be regarding 1.8 exclusively - 1.7 has incomplete and not well documented API.
You can have a look here - 1.8 API Introduction
The API documentation is also linked several times in this guide.
That being said, I’m not 100% clear on what do you want to achieve, so if you could please describe it in more details, we might be able to help.