Semantic Search

This topic describe the procedure on how you can do the semantic search in the Search and Match API.

Semantic search is a technology that understands the meaning of words and phrases. Unlike traditional search, which looks for exact matches of the query words, semantic search interprets the overall meaning to find more relevant results.

The Search and Match API results have been enhanced by implementing a semantic AI search technique. With this update, the Search and Match API now matches based on both the actual keywords in the query and their meanings. For example if the query is Project Manager in Maxico, then semantic search not only search with Job Profile "Project Manager" but also search with similar Job Profiles that have same meaning like "development project manager OR business project manager OR sharepoint project manager OR project engineering manager OR project manager OR project management department manager OR salesforce project manager OR software project manager OR project development manager OR engineering project manager".

To use the semantic search in the API response, you need to add semanticSearch parameter in your API request and set it to True. Refer to the example below for reference:

"semanticSearch": true
Note:
  • Semantic Search is currently applicable with the Job Profile keyword in the query.
  • The maximum 10 similar Job Profiles are used for the Semantic Search.
  • The Semantic Search feature may experience some latency as it leverages AI technology for enhanced results.
  • The semanticSearch parameter 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.
  • The Semantic Search uses the AI to get the similar JobProfile but if you want to use Taxonomy API for getting similar skills and job profiles, you can use the Ontology Search features.

Sample Request

Note: The below sample request is for Simple Search API, similarly, you can pass semanticSearch in Match, Match with ID, Match with Multiple Sub-User Ids, and One To One Match.
{
    "index": {
        "indexType": "Resume",
        "indexKey": "Use your index key"
    },
    "query": {
        "keyword": "Project Manager in Mexico"
    },
    "semanticSearch": true,
    "pageSize": 10,
    "pageStart": 0,
    "explainScore": true,
    "explainScoreType": "json"
}

Sample Response

Note: The below sample response is for Simple Search API, similarly, you can get response for Match, Match with ID, Match with Multiple Sub-User Ids, and One To One Match.
{
    "count": 5,
    "pageStart": 0,
    "pageSize": 10,
    "records": [
        {
            "id": "230216113657257OKNVNU8C",
            "score": 70.0,
            "CurrentEmployer": "ABB Software Enterprise",
            "TotalExperienceInYear": 7.7,
            "CurrentJobProfile": "Software Engineer",
            "State": "CO",
            "FullName": "Alejandro Coutin",
            "Country": "USA",
            "City": "Boulder"
        },
        {
            "id": "1675339664739",
            "score": 70.0,
            "CurrentEmployer": "ABB Software Enterprise",
            "TotalExperienceInYear": 7.7,
            "CurrentJobProfile": "Software Engineer",
            "State": "CO",
            "FullName": "Alejandro Coutin",
            "Country": "USA",
            "SubUserId": "rchilliapitesting",
            "City": "Boulder"
        },
        {
            "id": "1675339527835",
            "score": 70.0,
            "CurrentEmployer": "ABB Software Enterprise",
            "TotalExperienceInYear": 7.7,
            "CurrentJobProfile": "Software Engineer",
            "State": "CO",
            "FullName": "Alejandro Coutin",
            "Country": "USA",
            "SubUserId": "rchilliapitesting",
            "City": "Boulder"
        },
        {
            "id": "1675337827290",
            "score": 70.0,
            "CurrentEmployer": "ABB Software Enterprise",
            "TotalExperienceInYear": 7.7,
            "CurrentJobProfile": "Software Engineer",
            "State": "CO",
            "FullName": "Alejandro Coutin",
            "Country": "USA",
            "SubUserId": "rchilliapitesting",
            "City": "Boulder"
        },
        {
            "id": "1675337565430",
            "score": 70.0,
            "CurrentEmployer": "ABB Software Enterprise",
            "TotalExperienceInYear": 7.7,
            "CurrentJobProfile": "Software Engineer",
            "State": "CO",
            "FullName": "Alejandro Coutin",
            "Country": "USA",
            "SubUserId": "rchilliapitesting",
            "City": "Boulder"
        }
    ],
    "explainScore": [
        {
            "id": "230216113657257OKNVNU8C",
            "explaination": {
                "score": 70.0,
                "maxScore": 100.0,
                "SimpleSearch": {
                    "score": 70.0,
                    "maxScore": 100.0,
                    "detailScore": [
                        {
                            "score": 70.0,
                            "maxScore": 87.5,
                            "entity": "JobAlias",
                            "value": "development project manager OR business project manager OR sharepoint project manager OR project engineering manager OR project manager OR project management department manager OR salesforce project manager OR software project manager OR project development manager OR engineering project manager"
                        },
                        {
                            "score": 0.0,
                            "maxScore": 12.5,
                            "entity": "City",
                            "value": "Mexico"
                        }
                    ]
                }
            }
        },
        {
            "id": "1675339664739",
            "SubUserId": "rchilliapitesting",
            "explaination": {
                "score": 70.0,
                "maxScore": 100.0,
                "SimpleSearch": {
                    "score": 70.0,
                    "maxScore": 100.0,
                    "detailScore": [
                        {
                            "score": 70.0,
                            "maxScore": 87.5,
                            "entity": "JobAlias",
                            "value": "development project manager OR business project manager OR sharepoint project manager OR project engineering manager OR project manager OR project management department manager OR salesforce project manager OR software project manager OR project development manager OR engineering project manager"
                        },
                        {
                            "score": 0.0,
                            "maxScore": 12.5,
                            "entity": "City",
                            "value": "Mexico"
                        }
                    ]
                }
            }
        },
        {
            "id": "1675337565430",
            "SubUserId": "rchilliapitesting",
            "explaination": {
                "score": 70.0,
                "maxScore": 100.0,
                "SimpleSearch": {
                    "score": 70.0,
                    "maxScore": 100.0,
                    "detailScore": [
                        {
                            "score": 70.0,
                            "maxScore": 87.5,
                            "entity": "JobAlias",
                            "value": "development project manager OR business project manager OR sharepoint project manager OR project engineering manager OR project manager OR project management department manager OR salesforce project manager OR software project manager OR project development manager OR engineering project manager"
                        },
                        {
                            "score": 0.0,
                            "maxScore": 12.5,
                            "entity": "City",
                            "value": "Mexico"
                        }
                    ]
                }
            }
        },
        {
            "id": "1675337827290",
            "SubUserId": "rchilliapitesting",
            "explaination": {
                "score": 70.0,
                "maxScore": 100.0,
                "SimpleSearch": {
                    "score": 70.0,
                    "maxScore": 100.0,
                    "detailScore": [
                        {
                            "score": 70.0,
                            "maxScore": 87.5,
                            "entity": "JobAlias",
                            "value": "development project manager OR business project manager OR sharepoint project manager OR project engineering manager OR project manager OR project management department manager OR salesforce project manager OR software project manager OR project development manager OR engineering project manager"
                        },
                        {
                            "score": 0.0,
                            "maxScore": 12.5,
                            "entity": "City",
                            "value": "Mexico"
                        }
                    ]
                }
            }
        },
        {
            "id": "1675339527835",
            "SubUserId": "rchilliapitesting",
            "explaination": {
                "score": 70.0,
                "maxScore": 100.0,
                "SimpleSearch": {
                    "score": 70.0,
                    "maxScore": 100.0,
                    "detailScore": [
                        {
                            "score": 70.0,
                            "maxScore": 87.5,
                            "entity": "JobAlias",
                            "value": "development project manager OR business project manager OR sharepoint project manager OR project engineering manager OR project manager OR project management department manager OR salesforce project manager OR software project manager OR project development manager OR engineering project manager"
                        },
                        {
                            "score": 0.0,
                            "maxScore": 12.5,
                            "entity": "City",
                            "value": "Mexico"
                        }
                    ]
                }
            }
        }
    ]
}