POST
/
v1
/
jobs
/
extract
curl --request POST \
  --url https://app.fastgen.ai/v1/jobs/extract \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Fastgen-Project: <fastgen-project>' \
  --data '{
  "description": "<string>"
}'
{
  "job_requirements": [
    "sound knowledge of full-stack development with Vue.js, Nuxt.js, Node.js and TypeScript",
    "several years of professional experience in software development"
  ],
  "job_attributes": {
    "professional_experience": {
      "values": [
        {
          "name": "years_of_experience",
          "value": "several years of professional experience",
          "type": "base",
          "weight": 5,
          "ai_reasoning": "The job description states the candidate should have several years of experience, indicating a base requirement for this role."
        }
      ],
      "weight": 10,
      "ai_reasoning": "The role requires multiple years of professional experience in software development, emphasizing the importance of hands-on experience with both front-end and back-end development."
    },
    "education_qualifications": {
      "values": [
        {
          "name": "relevant_degree",
          "value": "IT Major or similar degree",
          "type": "base",
          "weight": 10,
          "ai_reasoning": "The description mentions a completed vocational training or computer science studies, suggesting a basic educational requirement for the role.",
          "values": 2
        }
      ],
      "weight": 10,
      "ai_reasoning": "A relevant degree or an equivalent qualification is required, as it sets a foundation for the technical aspects of the role."
    },
    "skills": {
      "technical_skills": {
        "value": [
          {
            "skill": "Vue.js",
            "proficiency_level": "advanced"
          },
          {
            "skill": "Nuxt.js",
            "proficiency_level": "advanced"
          }
        ],
        "type": "base",
        "weight": 50,
        "ai_reasoning": "The job listing specifies advanced skills in Vue.js, Nuxt.js, Node.js, and TypeScript as crucial. Additionally, experience with Docker, Kubernetes, Vue Storefront, Scayle, and modern software development practices like CI/CD is highlighted as ideal."
      },
      "soft_skills": {
        "value": [
          {
            "skill": "analytical skills",
            "proficiency_level": "advanced"
          },
          {
            "skill": "communication skills",
            "proficiency_level": "advanced"
          },
          {
            "skill": "technical skills",
            "proficiency_level": "advanced"
          }
        ],
        "type": "base",
        "weight": 20,
        "ai_reasoning": "The listing highlights the need for analytical, technical, and communication skills, which are essential for problem-solving and collaborating effectively with stakeholders."
      },
      "language_skills": {
        "value": [],
        "type": "base",
        "weight": 0,
        "ai_reasoning": "No specific language skills other than technical language for communication are specified."
      },
      "adaptability": {
        "value": "willingness to work with modern development practices",
        "type": "base",
        "weight": 20,
        "ai_reasoning": "The candidate should appreciate modern software development practices, such as CI/CD and pair programming, indicating a high level of adaptability to new technologies."
      },
      "weight": 70,
      "ai_reasoning": "Skills are emphasized heavily, given the technical nature of the role, with specific requirements around fullstack development and the use of various programming frameworks and tools."
    },
    "additional_factors": {
      "values": [
        {
          "name": "location",
          "value": "Berlin",
          "type": "base",
          "weight": 5,
          "ai_reasoning": "The job location is specified as Berlin, which might be relevant for potential candidates."
        }
      ],
      "weight": 10,
      "ai_reasoning": "While the focus is on technical skills and experience, location is specified, which might influence the candidate's decision to apply."
    }
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Fastgen-Project
string
required

Body

application/json
description
string

The job description to be used for generating a scoring template

Response

200 - application/json
Successful response
job_requirements
string[]
job_attributes
object