Experience Range Deviation

The experienceRangeDeviation parameter when passed in the search and match API request and if it is TRUE, then the search result is based on the criteria as describe in this topic.

  1. Experience Exact Match: If the experience mentioned in the searched query is exactly matches with the candidate experience, then 100% match score is given to the candidate. For example, if the search query is Java developer with 4 years of experience then:
    • Candidate with experience 4 to 5 years given 100% score.
      Note: In case of resume to JD search, JD with experience 3 to 4 years given 100% score.
  2. Experience (-1, +1): If a candidate's experience falls within a range of one year less or one year more than the required experience in the searched query, then the candidate is given a match score of 75%. For example, if the search query is Java developer with 4 to 6 years of experience then:
    • Candidate with experience 4 to 6 years given 100% score.
    • Candidate with experience 3 to 4 years is given 75% score.
    • Candidate with experience 6 to 7 years is given 75% score.
  3. Experience (+2): If a candidate's experience exceeds the required experience in the search query by up to two years, they are assigned a match score of 50%. For example, if the search query is Java developer with 4 to 6 years of experience then:
    • Candidate with experience of 7-8 years is given 50% match score.
  4. Candidates with experience falling below -1 year or exceeding +2 years relative to the required experience specified in the search query are excluded from the API search results.

The experienceRangeDeviation is an optional parameter (query) that can be passed in the API request of Simple Search, Match, Match with ID, Match with Multiple Sub-User Ids, and One To One Match.

Sample Request for Searching Resume

{
    "index": {
        "indexType": "Resume",
        "indexKey": "Use you indexkey"
    },
    "query": {
        "keyword": "Java Developer with 3 year exp"
    },
    "experienceRangeDeviation": true,
    "pageSize": 10,
    "pageStart": 0,
    "explainScore": true,
    "explainScoreType": "json"
}

Sample Response for Searching Resume

{
    "count": 88,
    "pageStart": 0,
    "pageSize": 10,
    "records": [
        {
            "id": "230216113730230SIY9EVVW",
            "score": 88.89,
            "CurrentEmployer": "Network Enhancers India",
            "TotalExperienceInYear": 5.9,
            "CurrentJobProfile": "Java developer",
            "FullName": "Ashish R Badhe"
        },
        {
            "id": "5",
            "score": 77.78,
            "TotalExperienceInYear": 13.11,
            "CurrentJobProfile": "Java Developer",
            "FullName": "Nelson Luz",
            "Country": "UK",
            "SubUserId": "manisha"
        },
        {
            "id": "230216113555255D6641KOO",
            "score": 62.22,
            "CurrentEmployer": "GEIRINA.",
            "TotalExperienceInYear": 9.4,
            "CurrentJobProfile": "Software Engineer",
            "State": "California",
            "FullName": "QIXIU JANET ZHANG",
            "Country": "USA",
            "City": "San Jose"
        },
        {
            "id": "1675339682642",
            "score": 62.22,
            "CurrentEmployer": "Simpli.Fi",
            "TotalExperienceInYear": 22.8,
            "CurrentJobProfile": "Software Engineer",
            "State": "TX",
            "FullName": "Gerald J. LePage",
            "Country": "USA",
            "SubUserId": "rchilliapitesting",
            "City": "Fort Worth"
        },
        {
            "id": "1675339500382",
            "score": 62.22,
            "CurrentEmployer": "GEIRINA.",
            "TotalExperienceInYear": 9.4,
            "CurrentJobProfile": "Software Engineer",
            "State": "California",
            "FullName": "QIXIU JANET ZHANG",
            "Country": "USA",
            "SubUserId": "rchilliapitesting",
            "City": "San Jose"
        },
        {
            "id": "1675338822494",
            "score": 62.22,
            "CurrentEmployer": "Simpli.Fi",
            "TotalExperienceInYear": 22.8,
            "CurrentJobProfile": "Software Engineer",
            "State": "TX",
            "FullName": "Gerald J. LePage",
            "Country": "USA",
            "SubUserId": "rchilliapitesting",
            "City": "Fort Worth"
        },
        {
            "id": "1675337841540",
            "score": 62.22,
            "CurrentEmployer": "Simpli.Fi",
            "TotalExperienceInYear": 22.8,
            "CurrentJobProfile": "Software Engineer",
            "State": "TX",
            "FullName": "Gerald J. LePage",
            "Country": "USA",
            "SubUserId": "rchilliapitesting",
            "City": "Fort Worth"
        },
        {
            "id": "1675337799336",
            "score": 62.22,
            "CurrentEmployer": "GEIRINA.",
            "TotalExperienceInYear": 9.4,
            "CurrentJobProfile": "Software Engineer",
            "State": "California",
            "FullName": "QIXIU JANET ZHANG",
            "Country": "USA",
            "SubUserId": "rchilliapitesting",
            "City": "San Jose"
        },
        {
            "id": "1675337539219",
            "score": 62.22,
            "CurrentEmployer": "GEIRINA.",
            "TotalExperienceInYear": 9.4,
            "CurrentJobProfile": "Software Engineer",
            "State": "California",
            "FullName": "QIXIU JANET ZHANG",
            "Country": "USA",
            "SubUserId": "rchilliapitesting",
            "City": "San Jose"
        },
        {
            "id": "1675337424700",
            "score": 62.22,
            "CurrentEmployer": "GEIRINA.",
            "TotalExperienceInYear": 9.4,
            "CurrentJobProfile": "Software Engineer",
            "State": "California",
            "FullName": "QIXIU JANET ZHANG",
            "Country": "USA",
            "SubUserId": "rchilliapitesting",
            "City": "San Jose"
        }
    ],
    "explainScore": [
        {
            "id": "1675337424700",
            "SubUserId": "rchilliapitesting",
            "explaination": {
                "score": 62.22,
                "maxScore": 100.0,
                "SimpleSearch": {
                    "score": 62.22,
                    "maxScore": 100.0,
                    "detailScore": [
                        {
                            "score": 62.22,
                            "maxScore": 77.78,
                            "entity": "JobProfile",
                            "value": "java developer"
                        },
                        {
                            "score": 0.0,
                            "maxScore": 22.22,
                            "entity": "TotalExperienceInYear",
                            "value": "[3.0 TO 4.0]"
                        }
                    ]
                }
            }
        },
        {
            "id": "1675338822494",
            "SubUserId": "rchilliapitesting",
            "explaination": {
                "score": 62.22,
                "maxScore": 100.0,
                "SimpleSearch": {
                    "score": 62.22,
                    "maxScore": 100.0,
                    "detailScore": [
                        {
                            "score": 62.22,
                            "maxScore": 77.78,
                            "entity": "JobAlias",
                            "value": "java developer"
                        },
                        {
                            "score": 0.0,
                            "maxScore": 22.22,
                            "entity": "TotalExperienceInYear",
                            "value": "[3.0 TO 4.0]"
                        }
                    ]
                }
            }
        },
        {
            "id": "230216113555255D6641KOO",
            "explaination": {
                "score": 62.22,
                "maxScore": 100.0,
                "SimpleSearch": {
                    "score": 62.22,
                    "maxScore": 100.0,
                    "detailScore": [
                        {
                            "score": 62.22,
                            "maxScore": 77.78,
                            "entity": "JobProfile",
                            "value": "java developer"
                        },
                        {
                            "score": 0.0,
                            "maxScore": 22.22,
                            "entity": "TotalExperienceInYear",
                            "value": "[3.0 TO 4.0]"
                        }
                    ]
                }
            }
        },
        {
            "id": "230216113730230SIY9EVVW",
            "explaination": {
                "score": 88.89,
                "maxScore": 100.0,
                "SimpleSearch": {
                    "score": 88.89,
                    "maxScore": 100.0,
                    "detailScore": [
                        {
                            "score": 77.78,
                            "maxScore": 77.78,
                            "entity": "CurrentJobProfile",
                            "value": "java developer"
                        },
                        {
                            "score": 11.11,
                            "maxScore": 22.22,
                            "entity": "TotalExperienceInYear",
                            "value": "[5.1 TO 6.0]"
                        }
                    ]
                }
            }
        },
        {
            "id": "1675337841540",
            "SubUserId": "rchilliapitesting",
            "explaination": {
                "score": 62.22,
                "maxScore": 100.0,
                "SimpleSearch": {
                    "score": 62.22,
                    "maxScore": 100.0,
                    "detailScore": [
                        {
                            "score": 62.22,
                            "maxScore": 77.78,
                            "entity": "JobAlias",
                            "value": "java developer"
                        },
                        {
                            "score": 0.0,
                            "maxScore": 22.22,
                            "entity": "TotalExperienceInYear",
                            "value": "[3.0 TO 4.0]"
                        }
                    ]
                }
            }
        },
        {
            "id": "1675339500382",
            "SubUserId": "rchilliapitesting",
            "explaination": {
                "score": 62.22,
                "maxScore": 100.0,
                "SimpleSearch": {
                    "score": 62.22,
                    "maxScore": 100.0,
                    "detailScore": [
                        {
                            "score": 62.22,
                            "maxScore": 77.78,
                            "entity": "JobProfile",
                            "value": "java developer"
                        },
                        {
                            "score": 0.0,
                            "maxScore": 22.22,
                            "entity": "TotalExperienceInYear",
                            "value": "[3.0 TO 4.0]"
                        }
                    ]
                }
            }
        },
        {
            "id": "5",
            "SubUserId": "manisha",
            "explaination": {
                "score": 77.78,
                "maxScore": 100.0,
                "SimpleSearch": {
                    "score": 77.78,
                    "maxScore": 100.0,
                    "detailScore": [
                        {
                            "score": 77.78,
                            "maxScore": 77.78,
                            "entity": "CurrentJobProfile",
                            "value": "java developer"
                        },
                        {
                            "score": 0.0,
                            "maxScore": 22.22,
                            "entity": "TotalExperienceInYear",
                            "value": "[3.0 TO 4.0]"
                        }
                    ]
                }
            }
        },
        {
            "id": "1675339682642",
            "SubUserId": "rchilliapitesting",
            "explaination": {
                "score": 62.22,
                "maxScore": 100.0,
                "SimpleSearch": {
                    "score": 62.22,
                    "maxScore": 100.0,
                    "detailScore": [
                        {
                            "score": 62.22,
                            "maxScore": 77.78,
                            "entity": "JobAlias",
                            "value": "java developer"
                        },
                        {
                            "score": 0.0,
                            "maxScore": 22.22,
                            "entity": "TotalExperienceInYear",
                            "value": "[3.0 TO 4.0]"
                        }
                    ]
                }
            }
        },
        {
            "id": "1675337799336",
            "SubUserId": "rchilliapitesting",
            "explaination": {
                "score": 62.22,
                "maxScore": 100.0,
                "SimpleSearch": {
                    "score": 62.22,
                    "maxScore": 100.0,
                    "detailScore": [
                        {
                            "score": 62.22,
                            "maxScore": 77.78,
                            "entity": "JobProfile",
                            "value": "java developer"
                        },
                        {
                            "score": 0.0,
                            "maxScore": 22.22,
                            "entity": "TotalExperienceInYear",
                            "value": "[3.0 TO 4.0]"
                        }
                    ]
                }
            }
        },
        {
            "id": "1675337539219",
            "SubUserId": "rchilliapitesting",
            "explaination": {
                "score": 62.22,
                "maxScore": 100.0,
                "SimpleSearch": {
                    "score": 62.22,
                    "maxScore": 100.0,
                    "detailScore": [
                        {
                            "score": 62.22,
                            "maxScore": 77.78,
                            "entity": "JobProfile",
                            "value": "java developer"
                        },
                        {
                            "score": 0.0,
                            "maxScore": 22.22,
                            "entity": "TotalExperienceInYear",
                            "value": "[3.0 TO 4.0]"
                        }
                    ]
                }
            }
        }
    ]
}

Sample Request for Searching JD

{
    "index": {
        "indexType": "JD",
        "indexKey": "Use your indexkey"
    },
    "query": {
        "keyword": "Java Developer with 3 year exp"
    },
    "experienceRangeDeviation": true,
    "pageSize": 10,
    "pageStart": 0,
    "explainScore": true,
    "explainScoreType": "json"
}

Sample Response for Searching JD

{
    "count": 14,
    "pageStart": 0,
    "pageSize": 10,
    "records": [
        {
            "id": "001",
            "score": 97.22,
            "JobProfile": "Java Developer",
            "Employer": "Stefanini",
            "City": "North York",
            "Country": "USA",
            "SubUserId": "manoj",
            "State": "CA"
        },
        {
            "id": "2211160130151115VL8ZHG3P",
            "score": 22.22,
            "JobProfile": "Front-End Web Developer",
            "Degree": [
                "Bachelor of Science",
                "Bachelor of Arts"
            ],
            "Employer": "Standard Furniture"
        },
        {
            "id": "202301190941",
            "score": 19.44,
            "JobProfile": "Electrical Engineer",
            "Degree": [
                "Bachelor",
                "Associates",
                "EFI"
            ]
        },
        {
            "id": "5206832308228015qwerty12345678123_2",
            "score": 19.44,
            "JobProfile": "Vice President of IT",
            "Employer": "Brilliant Technology Staffing",
            "City": "Chicago",
            "Country": "United States of America",
            "State": "Illinois"
        },
        {
            "id": "5206832308228015qwerty12345678123_1",
            "score": 19.44,
            "JobProfile": "Inside Sales Representative",
            "Employer": "Stefanini",
            "City": "North York",
            "Country": "CA",
            "State": "CA"
        },
        {
            "id": "23080109340686YR15UTRN",
            "score": 11.11,
            "JobProfile": "مدير المشروع",
            "Degree": [
                "البكالوريوس درجة البكالوريوس في إدارة المشاريع"
            ],
            "Employer": "شركة قطر الوطنية للأسمنت",
            "City": "الرياض",
            "Country": "Saudi Arabia",
            "State": "Riyadh"
        },
        {
            "id": "2308010929508506MBSIR2A",
            "score": 11.11,
            "JobProfile": "محلل الأعمال",
            "Degree": [
                "البكالوريوس درجة البكالوريوس في إدارة الأعمال"
            ],
            "Employer": "مجموعة شاطئ البحر",
            "City": "مسقط",
            "Country": "عمان",
            "State": "Muscat"
        },
        {
            "id": "230801092533833AI4874PY",
            "score": 11.11,
            "JobProfile": "عالم البيانات",
            "Degree": [
                "البكالوريوس<درجة البكالوريوس"
            ],
            "Employer": "بنك مسقط"
        },
        {
            "id": "230801092315815QQDJA3R6",
            "score": 11.11,
            "JobProfile": "يفة مدير مالي",
            "Degree": [
                "البكالوريوس<درجة البكالوريوس"
            ],
            "Employer": "يونايتد نتوركس",
            "City": "مدينة الكويت",
            "Country": "الكويت",
            "State": "Kuwait City"
        },
        {
            "id": "23080109230787TB4Y7X1L",
            "score": 11.11,
            "JobProfile": "مدير مالي",
            "Degree": [
                "درجة الماجستير"
            ],
            "Employer": "الخطوط الجوية الكويتية",
            "City": "مدينة الكويت",
            "Country": "الكويت",
            "State": "Kuwait City"
        }
    ],
    "explainScore": [
        {
            "id": "230801092533833AI4874PY",
            "explaination": {
                "score": 11.11,
                "maxScore": 100.0,
                "SimpleSearch": {
                    "score": 11.11,
                    "maxScore": 100.0,
                    "detailScore": [
                        {
                            "score": 0.0,
                            "maxScore": 77.78,
                            "entity": "JobProfile",
                            "value": "Java Developer"
                        },
                        {
                            "score": 11.11,
                            "maxScore": 11.11,
                            "entity": "MinimumYearsExperience",
                            "value": "[3.0 TO 5.0]"
                        },
                        {
                            "score": 0.0,
                            "maxScore": 11.11,
                            "entity": "MaximumYearsExperience",
                            "value": "[3.0 TO 5.0]"
                        }
                    ]
                }
            }
        },
        {
            "id": "230801092315815QQDJA3R6",
            "explaination": {
                "score": 11.11,
                "maxScore": 100.0,
                "SimpleSearch": {
                    "score": 11.11,
                    "maxScore": 100.0,
                    "detailScore": [
                        {
                            "score": 0.0,
                            "maxScore": 77.78,
                            "entity": "JobProfile",
                            "value": "Java Developer"
                        },
                        {
                            "score": 11.11,
                            "maxScore": 11.11,
                            "entity": "MinimumYearsExperience",
                            "value": "[3.0 TO 5.0]"
                        },
                        {
                            "score": 0.0,
                            "maxScore": 11.11,
                            "entity": "MaximumYearsExperience",
                            "value": "[3.0 TO 5.0]"
                        }
                    ]
                }
            }
        },
        {
            "id": "001",
            "SubUserId": "manoj",
            "explaination": {
                "score": 97.22,
                "maxScore": 100.0,
                "SimpleSearch": {
                    "score": 97.22,
                    "maxScore": 100.0,
                    "detailScore": [
                        {
                            "score": 77.78,
                            "maxScore": 77.78,
                            "entity": "JobProfileTitle",
                            "value": "java developer"
                        },
                        {
                            "score": 8.33,
                            "maxScore": 11.11,
                            "entity": "MinimumYearsExperience",
                            "value": "[2.0 TO 2.9]"
                        },
                        {
                            "score": 11.11,
                            "maxScore": 11.11,
                            "entity": "MaximumYearsExperience",
                            "value": "[3.0 TO 5.0]"
                        }
                    ]
                }
            }
        },
        {
            "id": "5206832308228015qwerty12345678123_2",
            "explaination": {
                "score": 19.44,
                "maxScore": 100.0,
                "SimpleSearch": {
                    "score": 19.44,
                    "maxScore": 100.0,
                    "detailScore": [
                        {
                            "score": 0.0,
                            "maxScore": 77.78,
                            "entity": "JobProfile",
                            "value": "Java Developer"
                        },
                        {
                            "score": 8.33,
                            "maxScore": 11.11,
                            "entity": "MinimumYearsExperience",
                            "value": "[2.0 TO 2.9]"
                        },
                        {
                            "score": 11.11,
                            "maxScore": 11.11,
                            "entity": "MaximumYearsExperience",
                            "value": "[3.0 TO 5.0]"
                        }
                    ]
                }
            }
        },
        {
            "id": "5206832308228015qwerty12345678123_1",
            "explaination": {
                "score": 19.44,
                "maxScore": 100.0,
                "SimpleSearch": {
                    "score": 19.44,
                    "maxScore": 100.0,
                    "detailScore": [
                        {
                            "score": 0.0,
                            "maxScore": 77.78,
                            "entity": "JobProfile",
                            "value": "Java Developer"
                        },
                        {
                            "score": 8.33,
                            "maxScore": 11.11,
                            "entity": "MinimumYearsExperience",
                            "value": "[2.0 TO 2.9]"
                        },
                        {
                            "score": 11.11,
                            "maxScore": 11.11,
                            "entity": "MaximumYearsExperience",
                            "value": "[3.0 TO 5.0]"
                        }
                    ]
                }
            }
        },
        {
            "id": "23080109340686YR15UTRN",
            "explaination": {
                "score": 11.11,
                "maxScore": 100.0,
                "SimpleSearch": {
                    "score": 11.11,
                    "maxScore": 100.0,
                    "detailScore": [
                        {
                            "score": 0.0,
                            "maxScore": 77.78,
                            "entity": "JobProfile",
                            "value": "Java Developer"
                        },
                        {
                            "score": 11.11,
                            "maxScore": 11.11,
                            "entity": "MinimumYearsExperience",
                            "value": "[3.0 TO 5.0]"
                        },
                        {
                            "score": 0.0,
                            "maxScore": 11.11,
                            "entity": "MaximumYearsExperience",
                            "value": "[3.0 TO 5.0]"
                        }
                    ]
                }
            }
        },
        {
            "id": "2308010929508506MBSIR2A",
            "explaination": {
                "score": 11.11,
                "maxScore": 100.0,
                "SimpleSearch": {
                    "score": 11.11,
                    "maxScore": 100.0,
                    "detailScore": [
                        {
                            "score": 0.0,
                            "maxScore": 77.78,
                            "entity": "JobProfile",
                            "value": "Java Developer"
                        },
                        {
                            "score": 11.11,
                            "maxScore": 11.11,
                            "entity": "MinimumYearsExperience",
                            "value": "[3.0 TO 5.0]"
                        },
                        {
                            "score": 0.0,
                            "maxScore": 11.11,
                            "entity": "MaximumYearsExperience",
                            "value": "[3.0 TO 5.0]"
                        }
                    ]
                }
            }
        },
        {
            "id": "2211160130151115VL8ZHG3P",
            "explaination": {
                "score": 22.22,
                "maxScore": 100.0,
                "SimpleSearch": {
                    "score": 22.22,
                    "maxScore": 100.0,
                    "detailScore": [
                        {
                            "score": 0.0,
                            "maxScore": 77.78,
                            "entity": "JobProfile",
                            "value": "Java Developer"
                        },
                        {
                            "score": 11.11,
                            "maxScore": 11.11,
                            "entity": "MinimumYearsExperience",
                            "value": "[3.0 TO 5.0]"
                        },
                        {
                            "score": 11.11,
                            "maxScore": 11.11,
                            "entity": "MaximumYearsExperience",
                            "value": "[3.0 TO 5.0]"
                        }
                    ]
                }
            }
        },
        {
            "id": "23080109230787TB4Y7X1L",
            "explaination": {
                "score": 11.11,
                "maxScore": 100.0,
                "SimpleSearch": {
                    "score": 11.11,
                    "maxScore": 100.0,
                    "detailScore": [
                        {
                            "score": 0.0,
                            "maxScore": 77.78,
                            "entity": "JobProfile",
                            "value": "Java Developer"
                        },
                        {
                            "score": 11.11,
                            "maxScore": 11.11,
                            "entity": "MinimumYearsExperience",
                            "value": "[3.0 TO 5.0]"
                        },
                        {
                            "score": 0.0,
                            "maxScore": 11.11,
                            "entity": "MaximumYearsExperience",
                            "value": "[3.0 TO 5.0]"
                        }
                    ]
                }
            }
        },
        {
            "id": "202301190941",
            "explaination": {
                "score": 19.44,
                "maxScore": 100.0,
                "SimpleSearch": {
                    "score": 19.44,
                    "maxScore": 100.0,
                    "detailScore": [
                        {
                            "score": 0.0,
                            "maxScore": 77.78,
                            "entity": "JobProfile",
                            "value": "Java Developer"
                        },
                        {
                            "score": 8.33,
                            "maxScore": 11.11,
                            "entity": "MinimumYearsExperience",
                            "value": "[2.0 TO 2.9]"
                        },
                        {
                            "score": 11.11,
                            "maxScore": 11.11,
                            "entity": "MaximumYearsExperience",
                            "value": "[3.0 TO 5.0]"
                        }
                    ]
                }
            }
        }
    ]
}

Error Code

Error Code Error Message
2121 experienceRangeDeviation must have value either true or false.