Endpoint Examples

/resumesearch

Searches stored resumes using various filters and matching criteria.

`POST` /searchservice/resumesearch

Headers

Name	Type	Description
`accept`	string, enum	Generated from available response content types. Allowed: `application/json` (default) and `application/xml`
`content-type`	string, enum	Generated from available request content types. Allowed: `application/json` (default) and `application/xml`

Request Body

{
  "searchCriteria": {
    "keyword": {
      "searchType": "Generic",
      "keywords": [
        {
          "value": "c#",
          "context": "LastJob",
          "logicalOperator": "Or"
        },
        {
          "value": "Java",
          "context": "LastJob"
        }
      ]
    },
    "additionalFilters": {
      "maximumDocumentCount": 30
    },
    "instanceType": "spectrum",
    "locale": "en_us",
    "vendor": "jobsrus"
  }
}

<ResumeSearchRequest xmlns="http://bgt.com/lens/model/searchservice/request">
    <SearchCriteria>
        <Keyword>
            <SearchType>Generic</SearchType>
            <Keywords>
                <Value>c#</Value>
                <Context>LastJob</Context>
                <LogicalOperator>Or</LogicalOperator>
            </Keywords>
            <Keywords>
                <Value>Java</Value>
                <Context>LastJob</Context>
            </Keywords>
        </Keyword>
        <AdditionalFilters>
            <MaximumDocumentCount>2</MaximumDocumentCount>
        </AdditionalFilters>
        <InstanceType>spectrum</InstanceType>
        <Locale>en_us</Locale>
        <Vendor>jobsrus</Vendor>
    </SearchCriteria>
</ResumeSearchRequest>

Code Examples

curl --request POST \
  --url "https://lensapi.burning-glass.com/v2.0/searchservice/resumesearch" \
  --header "Authorization: <OAUTH_AUTHENTICATION_HEADER>" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \

curl --request POST \
  --url "https://lensapi.burning-glass.com/v2.0/searchservice/resumesearch" \
  --header "Authorization: <OAUTH_AUTHENTICATION_HEADER>" \
  --header "Accept: application/xml" \
  --header "Content-Type: application/xml" \
  --data '<ResumeSearchRequest xmlns="http://bgt.com/lens/model/searchservice/request">
    <SearchCriteria>
        <Keyword>
            <SearchType>Generic</SearchType>
            <Keywords>
                <Value>c#</Value>
                <Context>LastJob</Context>
                <LogicalOperator>Or</LogicalOperator>
            </Keywords>
            <Keywords>
                <Value>Java</Value>
                <Context>LastJob</Context>
            </Keywords>
        </Keyword>
        <AdditionalFilters>
            <MaximumDocumentCount>2</MaximumDocumentCount>
        </AdditionalFilters>
        <InstanceType>spectrum</InstanceType>
        <Locale>en_us</Locale>
        <Vendor>jobsrus</Vendor>
    </SearchCriteria>
</ResumeSearchRequest>'

Response Examples

{
  "status": true,
  "statusCode": "OK",
  "requestId": "79a6afec-e21a-4a71-b5f0-dd4f4adba2eb",
  "responseData": {
    "vendorName": "jobsrus",
    "locale": "en_us",
    "instanceType": "spectrum",
    "resultsCount": 2,
    "offset": 1,
    "maxDocumentCount": 2,
    "minimumScore": 0,
    "candidates": [
      {
        "resumeId": "191882.txt",
        "name": "DING TAN",
        "score": 1,
        "yrsExp": 11,
        "employmentHistory": [
          {
            "jobTitle": "Process Engineer",
            "employer": "Pactiv Corporation",
            "start": "2002",
            "end": "2002"
          },
          {
            "jobTitle": "Product Development Engineer",
            "employer": "Nextec Applications",
            "start": "2001",
            "end": "2001"
          },
          {
            "jobTitle": "Process Engineer",
            "employer": "Sola Optical USA",
            "start": "1999",
            "end": "2001"
          }
        ],
        "educationHistory": [
          {
            "degree": "Master's Degree",
            "major": "Chemical Engineering",
            "end": "5/1991"
          },
          {
            "degree": "Bachelor's Degree",
            "major": "Chemical Engineering",
            "end": "8/1988"
          }
        ],
        "locationHistory": [
          {
            "city": "OCEANSIDE",
            "state": "CA"
          }
        ]
      },
      {
        "resumeId": "37ccb54e-1634-444b-83a0-cc3f00c15497",
        "score": 1
      }
    ]
  },
  "timeStamp": "2016-02-22 21:07:12.938"
}

<ResumeSearchResponse>
    <Status>true</Status>
    <StatusCode>OK</StatusCode>
    <RequestId>92009c20-25aa-4906-8313-a49c9b378648</RequestId>
    <ResponseData>
        <VendorName>jobsrus</VendorName>
        <Locale>en_us</Locale>
        <InstanceType>spectrum</InstanceType>
        <ResultsCount>2</ResultsCount>
        <Offset>1</Offset>
        <MaxDocumentCount>2</MaxDocumentCount>
        <MinimumScore>0</MinimumScore>
        <Candidates>
            <ResumeId>191882.txt</ResumeId>
            <Name>DING TAN</Name>
            <Score>1</Score>
            <YrsExp>11</YrsExp>
            <EmploymentHistory>
                <JobTitle>Process Engineer</JobTitle>
                <Employer>Pactiv Corporation</Employer>
                <Start>2002</Start>
                <End>2002</End>
            </EmploymentHistory>
            <EmploymentHistory>
                <JobTitle>Product Development Engineer</JobTitle>
                <Employer>Nextec Applications</Employer>
                <Start>2001</Start>
                <End>2001</End>
            </EmploymentHistory>
            <EmploymentHistory>
                <JobTitle>Process Engineer</JobTitle>
                <Employer>Sola Optical USA</Employer>
                <Start>1999</Start>
                <End>2001</End>
            </EmploymentHistory>
            <EducationHistory>
                <Degree>Master's Degree</Degree>
                <Major>Chemical Engineering</Major>
                <End>5/1991</End>
            </EducationHistory>
            <EducationHistory>
                <Degree>Bachelor's Degree</Degree>
                <Major>Chemical Engineering</Major>
                <End>8/1988</End>
            </EducationHistory>
            <LocationHistory>
                <City>OCEANSIDE</City>
                <State>CA</State>
            </LocationHistory>
            <MatchExplanation />
        </Candidates>
        <Candidates>
            <ResumeId>37ccb54e-1634-444b-83a0-cc3f00c15497</ResumeId>
            <Name />
            <Score>1</Score>
            <MatchExplanation />
        </Candidates>
    </ResponseData>
    <TimeStamp>2016-02-22 21:05:03.618</TimeStamp>
</ResumeSearchResponse>