Job Coverage

Analyzes how well your indexed resume pool covers your current job openings to prioritize sourcing.

Request Details

query Parameters

Field	Type	Required	Description
topK	number	No	number of jobs to return (default 50)
threshold	number	No	coverage threshold 0-1 for 'low' (default 0.3)

Sample Request & Response

GET

/v1/intelligence/jobs/coverage

Sample Request

Headers:

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

Query Parameters:

{
  "topK": "number (optional) - number of jobs to return (default 50)",
  "threshold": "number (optional) - coverage threshold 0-1 for 'low' (default 0.3)"
}

Sample Response (200)

{
  "generatedAt": "2025-08-08T12:00:00Z",
  "parameters": {
    "matchThreshold": 0.7,
    "labelThresholds": {
      "low": 0.3,
      "high": 0.7
    }
  },
  "summary": {
    "totalJobs": 42,
    "lowCoverageJobs": 11,
    "topMissingSkills": [
      "Kubernetes",
      "Golang",
      "ETL"
    ]
  },
  "jobs": [
    {
      "jobId": "job_123",
      "title": "Data Analyst",
      "coverageScore": 0.18,
      "coverageLabel": "low",
      "matchedResumes": 3,
      "topMatches": [
        {
          "resumeId": "resume_a1",
          "score": 0.78
        },
        {
          "resumeId": "resume_b2",
          "score": 0.74
        }
      ],
      "missingSkillsTop": [
        "dbt",
        "Airflow"
      ],
      "locationFit": {
        "matchRate": 0.33
      },
      "seniorityFit": {
        "matchRate": 0.67
      }
    },
    {
      "jobId": "job_456",
      "title": "Full Stack Developer",
      "coverageScore": 0.82,
      "coverageLabel": "high",
      "matchedResumes": 25,
      "topMatches": [
        {
          "resumeId": "resume_c3",
          "score": 0.91
        },
        {
          "resumeId": "resume_d4",
          "score": 0.89
        },
        {
          "resumeId": "resume_e5",
          "score": 0.87
        }
      ],
      "missingSkillsTop": [
        "GraphQL"
      ],
      "locationFit": {
        "matchRate": 0.88
      },
      "seniorityFit": {
        "matchRate": 0.84
      }
    }
  ]
}