Use of the Search Extension Framework using API

We want to use the Search Extension Framework using an API similar to how users search it through the UI, where users key in some content to search and the framework then returns the list of Contracts along with the attachments that contain the search content.

We would like to use the same functionality to be consumed using REST / SOAP API.

Could you please share details on this, since I did not find any API with these details.