# Search Preview

## Introduction to Search Preview

The Search Preview feature enhances search functionality by returning up to 20 top matching results with essential contextual data in a single API call. Unlike our standard Search endpoints, which return only record IDs and require subsequent API Collect calls, `preview` endpoints significantly reduce frontend latency, enabling more responsive and user-friendly search experiences and unlocking new capabilities.

### Discover products

Find all APIs with search preview endpoints, request samples and included response fields.

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td>Multi-source Company API search preview</td><td><a href="/pages/3vpwzNCvx7JHVcHEPB4o">/pages/3vpwzNCvx7JHVcHEPB4o</a></td></tr><tr><td>Clean Company API search preview</td><td><a href="/pages/R0Sf71WLw8P4UHSPBpwE">/pages/R0Sf71WLw8P4UHSPBpwE</a></td></tr><tr><td>Base Company API search preview</td><td><a href="/pages/YUH8IlGaB6s1MWXUlXSN">/pages/YUH8IlGaB6s1MWXUlXSN</a></td></tr><tr><td>Multi-source Employee API search preview</td><td><a href="/pages/zPGaL3BIW436noNYjbAE">/pages/zPGaL3BIW436noNYjbAE</a></td></tr><tr><td>Clean Employee API search preview</td><td><a href="/pages/R5S0uotn3Q2bRPC7IlT2">/pages/R5S0uotn3Q2bRPC7IlT2</a></td></tr><tr><td>Base Employee API search preview</td><td><a href="/pages/cCOBcAg7U0o9Ac3Ou0BJ">/pages/cCOBcAg7U0o9Ac3Ou0BJ</a></td></tr><tr><td>Multi-source Jobs API search preview</td><td><a href="/pages/vbkZTw3erzjDM0XxgC9H">/pages/vbkZTw3erzjDM0XxgC9H</a></td></tr><tr><td>Base Jobs API search preview</td><td><a href="/pages/N2x1wbaqlqvjuf8rRRW7">/pages/N2x1wbaqlqvjuf8rRRW7</a></td></tr></tbody></table>

## Requests and queries

* Search Preview endpoints accept the same query structure as their corresponding Search endpoints. You can reference the existing Search endpoint documentation for each entity type, as the filtering and query logic are very similar
* Pagination is not mandatory
* The `_sort` function is not supported, meaning sorting order in the results cannot be specified

## Response behavior and headers

1. Request returns a list of objects. Each object includes:

* A limited set of predefined fields, specific to the entity type
* Record ID
* Elasticsearch match score

2. Response gives up to 20 results per request, without using pagination

### Fewer response headers are returned

* `x-total-results`: Reflects the total number of matched records
* `x-credits-remaining`: Shows remaining search credits for the user

## Pagination

Pagination with Search Preview endpoints allows receiving up to 5 pages of results, therefore, accessing up to 100 results. To view a specific page, the user must include the query parameter `page` and provide the corresponding page number they wish to retrieve. Each request to open a new page will consume additional credits.

## Credits

Search Preview requests consume credits by the same logic described in the [Credits](/api-introduction/credits.md) topic.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.coresignal.com/api-introduction/requests/search-preview.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.