Job Pool Insights

Breaks down your open job inventory by role, location, seniority, and employment type, with signal-based aggregates like top required skills and posting recency.

Request Details

query Parameters

Field	Type	Required
status	string	No
from	string	No
to	string	No
limitRoles	number	No

Sample Request & Response

GET

/v1/intelligence/jobs/pool

Sample Request

Headers:

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

Query Parameters:

{
  "status": "string (optional) – open | closed | all (default open)",
  "from": "string (optional) – ISO timestamp for start of window",
  "to": "string (optional) – ISO timestamp for end of window",
  "limitRoles": "number (optional) – max roles to return (default 25)"
}

Sample Response (200)

{
  "generatedAt": "2025-08-08T12:00:00Z",
  "roles": {
    "Software Engineer": 18,
    "Product Manager": 6
  },
  "locations": {
    "Toronto": 12,
    "Remote": 8
  },
  "seniorityLevels": {
    "Junior": 4,
    "Mid": 12,
    "Senior": 8
  },
  "employmentTypes": {
    "Full-time": 15,
    "Contract": 7,
    "Internship": 1
  },
  "topRequiredSkills": [
    "JavaScript",
    "React",
    "SQL"
  ],
  "averageSalaryRange": {
    "min": 70000,
    "max": 120000,
    "currency": "CAD",
    "period": "year"
  },
  "postedWithin": {
    "last7Days": 10,
    "last30Days": 20
  },
  "skillsGapsInPool": [
    "Kubernetes",
    "Rust"
  ]
}