# Employees API
Here is the list of default parameters you can use with this API:
| Parameters | |
| :-------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
| api\_key
required
| This is your API key. |
| domain
required
| Type: String
The domain of the company for which you need employees.
|
| city | Type: String
The city from which you need the employees.
|
| position | Type: String
The job title you wish to target for the employees.
|
| size | Type: Number(Integer)
\[1,2,3....40]
Default: 1
(Enter 1 for 10 results per page, 2 for 20 results per page, etc .)
Each page returns 10 employees of a company by default. However, if you wish to obtain more data, you can implement this size parameter.
Note: It can return a maximum of 400 results only.
|
| page | Type: Number(Integer)
\[1,2,3....]
Default: 1
(Enter 1 for 1st-page results, 2 for 2nd, etc .)
Each page returns 10 employees of a company. However, if you wish to obtain more data, you can implement this size parameter with the page parameter.
|
**Note:**
1. **Each Employee API request will cost you 10 request credits.**
2. **Initiate your request from the first page before retrieving data from the next pages.**
### API Example:
{% tabs %}
{% tab title="cURL" %}
```json
cURL "https://api.enrichmentapi.io/employees?api_key=APIKEY&domain=ibm.com"
```
{% endtab %}
{% tab title="Node JS" %}
```javascript
const axios = require('axios');
axios.get('https://api.enrichmentapi.io/employees?api_key=APIKEY&domain=ibm.com')
.then(response => {
console.log(response.data);
})
.catch(error => {
console.log(error);
});
```
{% endtab %}
{% tab title="Python" %}
```python
import requests
payload = {'api_key': 'APIKEY', 'domain':'ibm.com'}
resp = requests.get('https://api.enrichmentapi.io/employees', params=payload)
print (resp.text)
```
{% endtab %}
{% tab title="Java" %}
```java
try {
String url = "https://api.enrichmentapi.io/employees?api_key=APIKEY&domain=ibm.com";
URL urlForGetRequest = new URL(url);
String readLine = null;
HttpURLConnection conection = (HttpURLConnection) urlForGetRequest.openConnection();
conection.setRequestMethod("GET");
int responseCode = conection.getResponseCode();
if (responseCode == HttpURLConnection.HTTP_OK) {
BufferedReader in = new BufferedReader(new InputStreamReader(conection.getInputStream()));
StringBuffer response = new StringBuffer();
while ((readLine = in.readLine()) != null) {
response.append(readLine);
}
in.close();
System.out.println(response.toString());
} else {
throw new Exception("Error in API Call");
}
} catch (Exception ex) {
ex.printStackTrace();
}
```
{% endtab %}
{% tab title="Ruby" %}
```ruby
require 'net/http'
require 'json'
params = {
:api_key => "APIKEY",
:domamin=> "ibm.com"
}
uri = URI('https://api.enrichmentapi.io/employees')
uri.query = URI.encode_www_form(params)
website_content = Net::HTTP.get(uri)
print(website_content)
```
{% endtab %}
{% tab title="PHP" %}
```php
```
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.