Resume Parsing

Parse resumes and CVs across all shapes and formats with a few lines of code.

Resume Parsing is a service that helps standardize all your candidates' resumes in any format (PDF, DOCX, JPEG, ...). Using advanced AI techniques, we leverage the implicit structure of resumes to build relevant profiles objects. These resulting objects suits well with HrFlow.ai's layers, such as Searching, Scoring, or Embedding.

Furthermore, by extracting semantic entities such as names, emails, phones, locations, companies, schools, degrees, job titles, skills, and more, Resume Parsing helps produce advanced dashboards and reports on your data.

📘

Prerequisites

  1. ✨ Create a Workspace
  2. 🔑 Get your API Key
  3. 🧠 Activate Profile Parsing API
  4. 🔌 Create a Source
  5. 🔌 Activating Real-time Parsing for a Source
  6. Download HrFlow.ai's Postman

📘

API Endpoint

Get more information about the endpoint 🧠 Parse a Resume in a Source.

Step 1: Configure your Postman Environment

Following the steps from the HrFlow.ai Postman publication will land you on this page:

2880

Configure Postman environment

First, click on the "Environments" tab on the left side of your Postman window. Then, fill in the Empty - Environment template with the correct values. The compulsory variables for Resume Parsing are:

Finally, save the environment and ensure that you selected Empty - Environment as your current environment.

1920

Step 2: Choose your Resume

Fill in the body parameters:

  • file: select the resume you want to parse
  • sync_parsing: set this value to 1 to get results instantly
1920

📘

Synchronous/Asynchronous Parsing

  • With Synchronous Parsing, your resume's Parsing Object will be available inside the response of your request.
  • With Asynchronous Parsing, your parsing request will be sent in the Parsing queue.

🚧

Real time parsing must be activated

Please refer to 🔌 Activating Real-time Parsing for a Source.

Advanced Topics

1. Asynchronous Parsing

By setting sync_parsing to 0, your parsing request will be sent to a Parsing queue.

1920

📘

Retrieving Asynchronous Parsing Results

  • Set a reference before sending your request.
  • Use a Webhook to be notified when your parsing request is processed (check 🔌 Create, Configure a Webhook for more details)

2. Try Resume Parsing in your Favorite Programming Language

You can use Postman to work with your favorite programming language. Here is an example with Python.

1920

We also provide a Python Software Development Kit called hrflow, which simplifies the use of our products.

import requests

url = "https://api.hrflow.ai/v1/profile/parsing/file"

payload={'source_key': 'YOUR_SOURCE_KEY',
         'sync_parsing': '1'}
files=[
  ('file', ('resume.pdf', open('vdZxkQ4Gx/resume.pdf','rb'),'application/pdf'))
]
headers = {
  'X-USER-EMAIL': 'YOUR_USER_EMAIL',
  'X-API-KEY': 'YOUR_SECRET_KEY',
  'Cookie': 'AWSALB=He2Ej4Q2VDwtgpS3WgmDWFR4/JIw8G4Cvrkrv2BOCw3VWG2zoQRmK7WWJe6SacFiS4JU8IAmpjm0CDSfOjybfAIT4bMIRoIrGbboF9Ncq4F/bVzfiZswNB+hEOMU; AWSALBCORS=He2Ej4Q2VDwtgpS3WgmDWFR4/JIw8G4Cvrkrv2BOCw3VWG2zoQRmK7WWJe6SacFiS4JU8IAmpjm0CDSfOjybfAIT4bMIRoIrGbboF9Ncq4F/bVzfiZswNB+hEOMU'
}

response = requests.request("POST", url, headers=headers, data=payload, files=files)

print(response.text)
from hrflow import Hrflow

client = Hrflow(api_secret="YOUR_SECRET_KEY", 
                api_user="YOUR_USER_EMAIL")

with open("resume.pdf","rb") as file:
  response = client.profile.parsing.add_file(source_key="YOUR_SOURCE_KEY",
                                             profile_file=file.read(),
                                             profile_content_type='application/pdf',
                                             sync_parsing=1)