Find Custom Headcount

POST /find-custom-headcount

Find custom employee headcount for a company with advanced filters.

Pricing

1 credit per call.

Parameters

Parameter	Type	Required	Description
linkedin_url	string	Yes	Company/school LinkedIn URL (must contain /company/, /showcase/, or /school/)
where_they_live	array	No	Array of geographic region IDs
where_they_studied	array	No	Array of school IDs
what_they_do	array	No	Array of function IDs
what_they_are_skilled_at	array	No	Array of skill IDs
what_they_studied	array	No	Array of field of study IDs
keywords	string	No	Search keywords
include_subsidiaries	string	No	Include subsidiaries ("true" or "false", default: "false")

Example Request

cURL

curl --request POST \
  --url https://api.infoplug.io/find-custom-headcount \
  --header 'Content-Type: application/json' \
  --header 'X-INFOPLUG-API-KEY: YOUR_API_KEY' \
  --data '{
    "linkedin_url": "https://www.linkedin.com/company/apple/",
    "where_they_live": ["103644278"],
    "what_they_do": ["8"],
    "include_subsidiaries": "true"
  }'

Python

import requests

url = "https://api.infoplug.io/find-custom-headcount"
headers = {
    "Content-Type": "application/json",
    "X-INFOPLUG-API-KEY": "YOUR_API_KEY"
}
data = {
    "linkedin_url": "https://www.linkedin.com/company/apple/",
    "where_they_live": ["103644278"],
    "what_they_do": ["8"],
    "include_subsidiaries": "true"
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

Node.js

const response = await fetch('https://api.infoplug.io/find-custom-headcount', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-INFOPLUG-API-KEY': 'YOUR_API_KEY'
  },
  body: JSON.stringify({
    linkedin_url: 'https://www.linkedin.com/company/apple/',
    where_they_live: ['103644278'],
    what_they_do: ['8'],
    include_subsidiaries: 'true'
  })
});
const data = await response.json();
console.log(data);

Example Response

200 OK

{
  "data": {
    "linkedin_url": "https://www.linkedin.com/company/apple/",
    "filters": {
      "where_they_live": ["103644278"],
      "what_they_do": ["8"],
      "include_subsidiaries": "true"
    },
    "headcount": 15420
  }
}

400 Bad Request

{
  "message": "invalid_parameter",
  "parameter": "linkedin_url",
  "details": "LinkedIn URL must contain /company/, /showcase/, or /school/"
}