Extract skills from a document

POST /extract/skills

Every skill evidenced in the document as {raw, canonical, taxonomy_id} — canonical names for any industry; taxonomy_id when the seed taxonomy knows the skill. Accepts text, url, or file.

Cost: 1 credit.

Request body

Field	Type	Description
`text`	string	Raw document text
`url`	string	http(s) URL of a document (PDF or text; 25s fetch timeout; 10MB cap)
`file`	string	Base64-encoded document bytes (PDF or plain text; 10MB cap)

Example request


curl -X POST "https://api.rezmatch.ai/extract/skills" \
  -H "x-access-key: $TALENTKIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "text": "Built dashboards in reactjs and tailwind, deployed on k8s."
}'

Example response


{
  "success": true,
  "data": {
    "skills": [
      {
        "raw": "reactjs",
        "canonical": "React",
        "taxonomy_id": "skill_react"
      },
      {
        "raw": "tailwind",
        "canonical": "Tailwind CSS",
        "taxonomy_id": "skill_tailwind"
      },
      {
        "raw": "k8s",
        "canonical": "Kubernetes",
        "taxonomy_id": "skill_kubernetes"
      }
    ]
  },
  "credits_used": 1,
  "request_id": "req_0f6f1151-81c7-47a8-8086-88de98682bcd"
}

Errors

Status	Meaning
`401`	invalid_key — missing, unknown, or revoked access key
`402`	insufficient_credits — top up in the dashboard; the failed call is not charged

All errors share the error envelope.

Try it

Open this endpoint in the interactive playground — requests run with your API key.