# 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