# Employee Posts API

## Overview

This section covers basic information on the Employee Posts API.

To learn more about the API and its endpoints, follow the links below:

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td>Employee Posts API endpoints</td><td><a href="#employee-posts-api-endpoints">#employee-posts-api-endpoints</a></td></tr><tr><td>Request types</td><td><a href="#request-types">#request-types</a></td></tr><tr><td>Rate limits</td><td><a href="#rate-limits">#rate-limits</a></td></tr><tr><td>Credits</td><td><a href="#credits">#credits</a></td></tr></tbody></table>

## Employee Posts API endpoints

{% hint style="info" %}
Our API is a data retrieval tool. The endpoints do not support analytic features.
{% endhint %}

Employee Posts API features two search endpoints and one collect endpoints to retrieve employee posts data.\
Use the endpoints with any API-compatible application.

| Request type | Endpoint                                | Function                                                           |
| ------------ | --------------------------------------- | ------------------------------------------------------------------ |
| POST         | */v2/employee\_post/search/filter*      | Search for relevant company profiles using search filters          |
| POST         | */v2/employee\_post/search/es\_dsl*     | An Elasticsearch DSL schema that maps directly to our output data. |
| GET          | */v2/employee\_post/collect/{post\_id}* | Convert the collected IDs to posts data                            |

## Request types

{% hint style="warning" %}
All Employee Posts API requests must be made over HTTPS. Requests made over HTTP will fail or be redirected to HTTPS.
{% endhint %}

Employee Posts API supports two types of requests:

* **Search** endpoints support POST requests only.
* **Collect** endpoints support GET requests only.

| Request type | Endpoint                                |
| ------------ | --------------------------------------- |
| POST         | */v2/employee\_post/search/filter*      |
| POST         | */v2/employee\_post/search/es\_dsl*     |
| GET          | */v2/employee\_post/collect/{post\_id}* |

## Rate limits

Employee Posts API endpoints restrict the number of requests allowed per second.

{% columns %}
{% column %}
Search endpoints

Collection endpoints
{% endcolumn %}

{% column %}
27 requests per second

54 requests per second
{% endcolumn %}
{% endcolumns %}

## Credits

**One** search credit is deducted for **one successful (200) request** in the search endpoints:

* */v2/employee\_post/search/filter*
* */v2/employee\_post/search/es\_dsl*

**One** collect credit is deducted for **one successful (200) request** in the collection endpoints:

* */v2/employee\_post/collect/{post\_id}*

***

Read more about credits in the following topic:

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td>General information about credits</td><td><a href="../api-introduction/credits">credits</a></td></tr></tbody></table>
