# Real-time Employee API

## Overview

Real-time Employee API provides real-time access to the most recent employee data. It significantly accelerates data retrieval whereas profiles are scraped and returned in less than 30 seconds on a cache miss.

Use the Real-time Employee API when you need the most current data of a profile – ideal for **Sales Tech, HR, Investment and AI applications**.

| **Real-time lead enrichment**            | Enrich leads as they enter your CRM with the most up-to-date job titles, company names, and contact information. No processing delays – get fresh data when you need it. |
| ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **On-demand prospect research**          | Validate employee data before outreach for various use cases. Catch role changes and company transitions and act on the most accurate data.                              |
| **Dynamic data retrieval for AI agents** | AI agents can fetch current employee data on demand to answer questions, verify information, or power autonomous workflows.                                              |

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td>Real-time Employee API endpoint</td><td><a href="/pages/H66K2GwKLXH9WjQl7Fop#real-time-employee-api-endpoint">/pages/H66K2GwKLXH9WjQl7Fop#real-time-employee-api-endpoint</a></td></tr><tr><td>Rate limits</td><td><a href="/pages/H66K2GwKLXH9WjQl7Fop#rate-limits">/pages/H66K2GwKLXH9WjQl7Fop#rate-limits</a></td></tr><tr><td>Credits</td><td><a href="/pages/H66K2GwKLXH9WjQl7Fop#credits">/pages/H66K2GwKLXH9WjQl7Fop#credits</a></td></tr><tr><td>Response codes</td><td><a href="/pages/bGCOCR5htxhPXKvDDdKZ#real-time-api-response-codes">/pages/bGCOCR5htxhPXKvDDdKZ#real-time-api-response-codes</a></td></tr></tbody></table>

## Real-time Employee API endpoint

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

Real-time Employee API has **one search** endpoint.

| Request type | Endpoint                    | Function                                                                         |
| ------------ | --------------------------- | -------------------------------------------------------------------------------- |
| POST         | */rtapi/v2/employee/scrape* | Submitting the scraping request for a specific Professional network user profile |

## Rate limits

The Real-time Employee API endpoints restrict the number of requests allowed per minute.

{% columns %}
{% column %}
Search endpoint
{% endcolumn %}

{% column %}
50 URLs per minute
{% endcolumn %}
{% endcolumns %}

## Credits

{% hint style="info" %}
Real-time Employee API credits are separated from other APIs credits. To add the credits, please reach out to your sales representative, account Manager or [contact us](https://coresignal.com/contact-us/).
{% endhint %}

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

* */rtapi/v2/employee/scrape*

***

## Discover next

<table data-view="cards"><thead><tr><th></th></tr></thead><tbody><tr><td><a href="/pages/gRTvKti366trE8ZqWCif">Real-time Employee API dictionary</a></td></tr><tr><td><a href="/pages/JIYsTBVMakHySqnfMiV1">Request sample</a></td></tr><tr><td><a href="/pages/zb6vKT9niESGOOkmHDOF">URL validation</a></td></tr></tbody></table>


---

# 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/employee-api/real-time-employee-api.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.
