Skills Intelligence

Surfaces in-demand, missing, and trending skills across your indexed resumes and jobs.

Request Details

query Parameters

Field	Type	Required	Description
scope	string	No	resumes \| jobs \| both (default both)
topK	number	No	number of skills to return per bucket (default 25)

Sample Request & Response

GET

/v1/intelligence/skills

Sample Request

Headers:

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

Query Parameters:

{
  "scope": "string (optional) - resumes | jobs | both (default both)",
  "topK": "number (optional) - number of skills to return per bucket (default 25)"
}

Sample Response (200)

{
  "generatedAt": "2025-08-08T12:00:00Z",
  "topSkills": [
    {
      "skill": "JavaScript",
      "count": 42
    },
    {
      "skill": "React",
      "count": 38
    },
    {
      "skill": "SQL",
      "count": 33
    }
  ],
  "missingSkills": [
    {
      "skill": "Kubernetes",
      "relatedRoles": [
        "DevOps Engineer",
        "Backend Engineer"
      ]
    },
    {
      "skill": "Rust",
      "relatedRoles": [
        "Systems Engineer"
      ]
    }
  ],
  "emergingSkills": [
    {
      "skill": "LangChain",
      "growthRate": "+250%"
    },
    {
      "skill": "Vector DBs",
      "growthRate": "+190%"
    }
  ],
  "decliningSkills": [
    {
      "skill": "jQuery",
      "growthRate": "-75%"
    }
  ],
  "skillsByCategory": {
    "Programming Languages": [
      "JavaScript",
      "Python",
      "TypeScript"
    ],
    "Frameworks": [
      "React",
      "Vue",
      "Django"
    ],
    "Databases": [
      "PostgreSQL",
      "MongoDB"
    ]
  }
}