Talent Pool Insights

Breaks down your indexed resume pool by role, location, and experience level.

Request Details

query Parameters

Field	Type	Required	Description
from	string	No	ISO timestamp to start aggregation window
to	string	No	ISO timestamp to end aggregation window
limitRoles	number	No	max roles to return (default 25)

Sample Request & Response

GET

/v1/intelligence/talent-pool

Sample Request

Headers:

{
  "Authorization": "Bearer <YOUR_API_KEY>"
}

Query Parameters:

{
  "from": "string (optional) - ISO timestamp to start aggregation window",
  "to": "string (optional) - ISO timestamp to end aggregation window",
  "limitRoles": "number (optional) - max roles to return (default 25)"
}

Sample Response (200)

{
  "generatedAt": "2025-08-08T12:00:00Z",
  "roles": {
    "Software Engineer": 42,
    "Product Manager": 17
  },
  "locations": {
    "Toronto": 30,
    "San Francisco": 25,
    "Munich": 8,
    "Melbourne": 5,
    "Guadalajara": 4,
    "Lagos": 3,
    "Remote": 20
  },
  "experienceLevels": {
    "Junior": 10,
    "Mid": 25,
    "Senior": 24
  },
  "averageYearsExperience": 5.8,
  "languages": {
    "English": 78,
    "French": 32,
    "Spanish": 14
  },
  "educationLevels": {
    "HighSchool": 5,
    "Associate": 7,
    "Bachelor": 55,
    "Master": 20,
    "Doctorate": 4
  },
  "careerProgression": {
    "Upward": 40,
    "Flat": 15,
    "Declining": 3,
    "Unclear": 5
  },
  "activityRecency": {
    "0-30d": 22,
    "31-90d": 34,
    "90d+": 13
  }
}