extract_candidate_profile

Normalize an English, Arabic or mixed-language CV into a machine-readable candidate profile using only stated professional evidence; protected personal attributes are ignored.

When to use

Use before scoring or matching a CV when an agent needs reusable structured candidate evidence.

Selection guidance

Role: supporting. Use before scoring or matching a CV when an agent needs reusable structured candidate evidence.

Use cases

• CV parsing
• resume extraction
• candidate profile
• ATS normalization

Access

• REST: POST https://api.rafidsystem.com/api/v1/recruitment/extract-candidate-profile
• x402: POST https://api.rafidsystem.com/api/v1/x402/recruitment/extract-candidate-profile
• MCP tool: extract_candidate_profile
• Free preview: POST https://api.rafidsystem.com/api/v1/preview/extract_candidate_profile

Price: $0.10 USD per call. Payment options are deployment-configured; inspect /api/v1/payment-methods. Prices and payment semantics are unchanged from the canonical registry.

Related tools

• cv_job_match
• cv_improve
• generate_job_profile
• candidate_shortlist_score

Example input

{
  "cv_text": "Senior Data Analyst\nExperience\nSenior Analyst at Example 2020-2024\nSkills\nPython, SQL, Power BI",
  "language": "auto",
  "target_schema_version": "1.0"
}

Example output

{
  "candidate": {
    "name": null,
    "headline": "Senior Data Analyst",
    "professional_summary": null,
    "location": null
  },
  "experience": [
    {
      "job_title": "Senior Analyst at Example 2020-2024",
      "company": "",
      "start_date": "",
      "end_date": "",
      "duration_months": null,
      "employment_type": null,
      "responsibilities": [],
      "achievements": [],
      "technologies": [
        "Python",
        "SQL",
        "Microsoft Power BI"
      ]
    }
  ],
  "education": [],
  "skills": [
    {
      "name": "Python",
      "category": "Professional",
      "confidence": 0.9,
      "evidence": [
        "Python"
      ]
    }
  ],
  "certifications": [],
  "languages": [],
  "projects": [],
  "industries": [],
  "management_experience": null,
  "total_experience_years": 5,
  "recent_role": "Senior Analyst at Example 2020-2024",
  "seniority_estimate": "senior",
  "career_progression": [],
  "candidate_keywords": [
    "Python",
    "SQL",
    "Microsoft Power BI"
  ],
  "evidence_quality": {
    "score": 60,
    "missing_information": [
      "education"
    ],
    "ambiguities": []
  }
}

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "cv_text": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200000
    },
    "document_url": {
      "type": "string",
      "maxLength": 2000,
      "format": "uri"
    },
    "language": {
      "default": "auto",
      "type": "string",
      "minLength": 1,
      "maxLength": 20
    },
    "target_schema_version": {
      "default": "1.0",
      "type": "string",
      "minLength": 1,
      "maxLength": 20
    }
  },
  "required": [
    "language",
    "target_schema_version"
  ],
  "additionalProperties": false
}

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "candidate": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "experience": {
      "type": "array",
      "items": {
        "type": "object",
        "propertyNames": {
          "type": "string"
        },
        "additionalProperties": {}
      }
    },
    "education": {
      "type": "array",
      "items": {
        "type": "object",
        "propertyNames": {
          "type": "string"
        },
        "additionalProperties": {}
      }
    },
    "skills": {
      "type": "array",
      "items": {
        "type": "object",
        "propertyNames": {
          "type": "string"
        },
        "additionalProperties": {}
      }
    },
    "certifications": {
      "type": "array",
      "items": {
        "type": "object",
        "propertyNames": {
          "type": "string"
        },
        "additionalProperties": {}
      }
    },
    "languages": {
      "type": "array",
      "items": {
        "type": "object",
        "propertyNames": {
          "type": "string"
        },
        "additionalProperties": {}
      }
    },
    "projects": {
      "type": "array",
      "items": {
        "type": "object",
        "propertyNames": {
          "type": "string"
        },
        "additionalProperties": {}
      }
    },
    "industries": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "management_experience": {
      "type": [
        "boolean",
        "null"
      ]
    },
    "total_experience_years": {
      "type": [
        "number",
        "null"
      ]
    },
    "recent_role": {
      "type": [
        "string",
        "null"
      ]
    },
    "seniority_estimate": {
      "type": [
        "string",
        "null"
      ]
    },
    "career_progression": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "candidate_keywords": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "evidence_quality": {
      "type": "object",
      "properties": {
        "score": {
          "type": "number",
          "minimum": 0,
          "maximum": 100
        },
        "missing_information": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "ambiguities": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "score",
        "missing_information",
        "ambiguities"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "candidate",
    "experience",
    "education",
    "skills",
    "certifications",
    "languages",
    "projects",
    "industries",
    "management_experience",
    "total_experience_years",
    "recent_role",
    "seniority_estimate",
    "career_progression",
    "candidate_keywords",
    "evidence_quality"
  ],
  "additionalProperties": false
}

Category: Recruitment Intelligence · hierarchy: supporting · idempotent: yes · side effects: no