urlcv
Back to Documentation

AI Job Description Parsing

📋 On This Page

  • Overview
  • How It Works
  • Extracted Information
  • Usage Guide
  • Best Practices
  • Limitations
  • Cost Considerations
  • Related Features

    • ---

    Overview

    The AI Job Description Parsing feature uses OpenAI GPT-4o to automatically extract structured information from job descriptions, whether uploaded as files or pasted as text. This enables rapid job creation with consistent, structured data.

    ---

    How It Works

    Process Flow

  • Input Job Description — Upload file or paste text
  • Text Extraction — Extract text from file (if uploaded)
  • AI Analysis — OpenAI GPT-4o analyzes the job description
  • Structured Extraction — AI returns JSON with job data
  • Job Creation — Job profile auto-populated with extracted data
  • Review & Edit — User reviews and adjusts as needed

    • Supported Input Methods

    File Upload:

  • PDF (preferred)
  • Word documents (.doc, .docx)
  • Plain text files (.txt)

    • Direct Text:

  • Paste job description text directly
  • No file upload required
  • Faster for simple job descriptions

    • ---

    Extracted Information

    The AI extracts comprehensive job details:

    Basic Information

  • Title — Job title/role name
  • Location — City/country (or null if remote/unspecified)
  • Description — Clean job description with responsibilities

    • Work Arrangement

  • Work Arrangement — One of:
    • - remote — Fully remote - hybrid — Hybrid work - office — Office-based - flexible — Flexible arrangement

    Contract Type

  • Contract Type — One of:
    • - permanent — Permanent position - contract — Contract/freelance role

    Experience Requirements

  • Min Years Experience — Minimum years required (integer)
  • Max Years Experience — Maximum years (integer, optional)

    • ---

    Compensation

    For Permanent Roles:

  • Salary Range Min — Minimum salary (number, no currency)
  • Salary Range Max — Maximum salary (number, no currency)

    • For Contract Roles:

  • Day Rate Min — Minimum day rate (number)
  • Day Rate Max — Maximum day rate (number)

    • ---

    Skills

  • Required Skills — Array of essential/required skills
  • Nice-to-Have Skills — Array of desirable skills

    • Additional Requirements

  • Required Work Rights — e.g., "Right to work in UK"
  • Required Availability — e.g., "Immediate start", "2 weeks notice"

    • ---

    Usage Guide

    Parsing from File

  • Navigate to Jobs → Create New
  • Click Parse Job Description
  • Choose Upload File
  • Select PDF, DOC, DOCX, or TXT file
  • Click Parse
  • Review extracted information
  • Edit any incorrect fields
  • Link to client company
  • Save job

    • ---

    Parsing from Text

  • Navigate to Jobs → Create New
  • Click Parse Job Description
  • Choose Paste Text
  • Paste job description text
  • Click Parse
  • Review and edit extracted data
  • Complete job creation

    • ---

    Reviewing Parsed Data

    Always Review:

  • Job title accuracy
  • Skills extraction (may miss some)
  • Experience requirements
  • Salary/day rate ranges
  • Location and work arrangement

    • Common Edits:

  • Add missing required skills
  • Adjust experience ranges
  • Correct salary ranges
  • Refine job description text
  • Update location details

    • ---

    Best Practices

  • Use Clear Job Descriptions — Better input = better extraction
  • Review All Fields — AI may miss or misinterpret some information
  • Add Missing Skills — Supplement AI-extracted skills
  • Verify Compensation — Check salary/day rate ranges
  • Normalize Skills — Standardize skill names for matching
  • Complete Missing Fields — Add any information AI missed

    • ---

    Limitations

    Supported Formats

  • PDF (text-based, not scanned)
  • Word documents (.doc, .docx)
  • Plain text (.txt)
  • Direct text paste

    • Not Supported

  • Scanned/image-only PDFs
  • Other file formats

    • AI Limitations

  • May miss some skills
  • May misinterpret ambiguous requirements
  • Salary extraction may need manual adjustment
  • Location parsing may be imprecise

    • ---

    Cost Considerations

    Pricing

  • Based on OpenAI GPT-4o pricing
  • Usage tracked per agency
  • Cost varies by job description length and complexity
  • Typically very affordable per job processed

    • Efficiency

  • Optimized for fast processing
  • Handles long job descriptions efficiently

    • ---

    🔗 Related Features

  • Client & Job Management — Managing jobs
  • AI Candidate Matching — Matching candidates to jobs
  • AI CV Parsing — Parsing candidate CVs