classifyOccupationsForJobDetails

Gets occupations matching the specified job details. Add more input for higher-quality results.

---

Arguments

input ClassifyOccupationsForJobDetailsInput! Required

description String

Job description. If description and jobTitle are empty, an error occurs.

jobTitle String

Job title. If description and jobTitle are empty, an error occurs.

companyName String

Company name for the job.

customClassFilter CustomClassFilterInput

Filters the occupations by custom class.

customClasses [ID!]! Required

Filters concepts by custom-class SUIDs.

operation CustomClassFilterOperation

Operator for custom class filtering. Default: AND.

countryCode CountryCode

Two-character country code in ISO 3166-1 alpha-2 format.

languageCode LanguageCode

Two-character language code in ISO 639 format.

includeDeprecated Boolean

Whether to include deprecated TaxonomyConcepts.

Response

Returns ClassifyOccupationsForJobDetailsPayload .

occupations [TaxonomyConcept!]! Non-Null

Occupations matching the input, ranked by confidence from highest to lowest. Tie order is not guaranteed.

key ID! Non-Null

Short unique ID (SUID) of the taxonomy concept. Primary key.

uuid ID! Non-Null

Universal unique ID (UUID) of the taxonomy concept. Prefer key instead.

label String! Non-Null

Preferred label of the concept.

Example: "Business etiquette"

alternativeLabels [String!]! Non-Null

Alternative labels for the concept.

Example: "Business manner"

mobileLabel String! Non-Null

Display label for the concept.

definitions [String!]! Non-Null

Definitions for the concept.

pathToRoot [TaxonomyConcept!]! Non-Null

Path from this concept to the taxonomy root.

key ID! Non-Null

Short unique ID (SUID) of the taxonomy concept. Primary key.

uuid ID! Non-Null

Universal unique ID (UUID) of the taxonomy concept. Prefer key instead.

label String! Non-Null

Preferred label of the concept.

Example: "Business etiquette"

alternativeLabels [String!]! Non-Null

Alternative labels for the concept.

Example: "Business manner"

mobileLabel String! Non-Null

Display label for the concept.

definitions [String!]! Non-Null

Definitions for the concept.

pathToRoot [TaxonomyConcept!]! Non-Null

Path from this concept to the taxonomy root.

children [TaxonomyConcept!]! Non-Null

Direct children of this concept in the taxonomy tree.

customClasses [CustomTaxonomyClass!]! Non-Null

Custom classes the concept belongs to.

Example: "Cross-Occupational Cluster"

taxonomyConceptType TaxonomyConceptType! Non-Null

Concept type.

isVerifiedJobAttribute Boolean! Non-Null

Whether the concept is a verified job attribute. Applies only when taxonomyConceptType is ATTRIBUTE.

isVerifiedResumeAttribute Boolean! Non-Null

Whether the concept is a verified resume attribute. Applies only when taxonomyConceptType is ATTRIBUTE.

children [TaxonomyConcept!]! Non-Null

Direct children of this concept in the taxonomy tree.

key ID! Non-Null

Short unique ID (SUID) of the taxonomy concept. Primary key.

uuid ID! Non-Null

Universal unique ID (UUID) of the taxonomy concept. Prefer key instead.

label String! Non-Null

Preferred label of the concept.

Example: "Business etiquette"

alternativeLabels [String!]! Non-Null

Alternative labels for the concept.

Example: "Business manner"

mobileLabel String! Non-Null

Display label for the concept.

definitions [String!]! Non-Null

Definitions for the concept.

pathToRoot [TaxonomyConcept!]! Non-Null

Path from this concept to the taxonomy root.

children [TaxonomyConcept!]! Non-Null

Direct children of this concept in the taxonomy tree.

customClasses [CustomTaxonomyClass!]! Non-Null

Custom classes the concept belongs to.

Example: "Cross-Occupational Cluster"

taxonomyConceptType TaxonomyConceptType! Non-Null

Concept type.

isVerifiedJobAttribute Boolean! Non-Null

Whether the concept is a verified job attribute. Applies only when taxonomyConceptType is ATTRIBUTE.

isVerifiedResumeAttribute Boolean! Non-Null

Whether the concept is a verified resume attribute. Applies only when taxonomyConceptType is ATTRIBUTE.

customClasses [CustomTaxonomyClass!]! Non-Null

Custom classes the concept belongs to.

Example: "Cross-Occupational Cluster"

key ID! Non-Null

SUID of this custom class. Primary key.

uuid ID! Non-Null

UUID of this custom class. Prefer key instead.

label String! Non-Null

Preferred label of the custom class. English only, not localized.

taxonomyConceptType TaxonomyConceptType! Non-Null

Concept type.

isVerifiedJobAttribute Boolean! Non-Null

Whether the concept is a verified job attribute. Applies only when taxonomyConceptType is ATTRIBUTE.

isVerifiedResumeAttribute Boolean! Non-Null

Whether the concept is a verified resume attribute. Applies only when taxonomyConceptType is ATTRIBUTE.

ancestors [TaxonomyConcept!]! Non-Null

Ancestors of the occupations in occupations.

For example, if occupations contains "Administrative Data Entry Specialists", then ancestors contains these occupations:

• "Administrative Assistants"
• "Administrative Support Occupations"
• "Administrative & Customer Support Occupations"

Returns ancestors in ranked order. Each ancestor inherits its original occupation's rank.

key ID! Non-Null

Short unique ID (SUID) of the taxonomy concept. Primary key.

uuid ID! Non-Null

Universal unique ID (UUID) of the taxonomy concept. Prefer key instead.

label String! Non-Null

Preferred label of the concept.

Example: "Business etiquette"

alternativeLabels [String!]! Non-Null

Alternative labels for the concept.

Example: "Business manner"

mobileLabel String! Non-Null

Display label for the concept.

definitions [String!]! Non-Null

Definitions for the concept.

pathToRoot [TaxonomyConcept!]! Non-Null

Path from this concept to the taxonomy root.

key ID! Non-Null

Short unique ID (SUID) of the taxonomy concept. Primary key.

uuid ID! Non-Null

Universal unique ID (UUID) of the taxonomy concept. Prefer key instead.

label String! Non-Null

Preferred label of the concept.

Example: "Business etiquette"

alternativeLabels [String!]! Non-Null

Alternative labels for the concept.

Example: "Business manner"

mobileLabel String! Non-Null

Display label for the concept.

definitions [String!]! Non-Null

Definitions for the concept.

pathToRoot [TaxonomyConcept!]! Non-Null

Path from this concept to the taxonomy root.

children [TaxonomyConcept!]! Non-Null

Direct children of this concept in the taxonomy tree.

customClasses [CustomTaxonomyClass!]! Non-Null

Custom classes the concept belongs to.

Example: "Cross-Occupational Cluster"

taxonomyConceptType TaxonomyConceptType! Non-Null

Concept type.

isVerifiedJobAttribute Boolean! Non-Null

Whether the concept is a verified job attribute. Applies only when taxonomyConceptType is ATTRIBUTE.

isVerifiedResumeAttribute Boolean! Non-Null

Whether the concept is a verified resume attribute. Applies only when taxonomyConceptType is ATTRIBUTE.

children [TaxonomyConcept!]! Non-Null

Direct children of this concept in the taxonomy tree.

key ID! Non-Null

Short unique ID (SUID) of the taxonomy concept. Primary key.

uuid ID! Non-Null

Universal unique ID (UUID) of the taxonomy concept. Prefer key instead.

label String! Non-Null

Preferred label of the concept.

Example: "Business etiquette"

alternativeLabels [String!]! Non-Null

Alternative labels for the concept.

Example: "Business manner"

mobileLabel String! Non-Null

Display label for the concept.

definitions [String!]! Non-Null

Definitions for the concept.

pathToRoot [TaxonomyConcept!]! Non-Null

Path from this concept to the taxonomy root.

children [TaxonomyConcept!]! Non-Null

Direct children of this concept in the taxonomy tree.

customClasses [CustomTaxonomyClass!]! Non-Null

Custom classes the concept belongs to.

Example: "Cross-Occupational Cluster"

taxonomyConceptType TaxonomyConceptType! Non-Null

Concept type.

isVerifiedJobAttribute Boolean! Non-Null

Whether the concept is a verified job attribute. Applies only when taxonomyConceptType is ATTRIBUTE.

isVerifiedResumeAttribute Boolean! Non-Null

Whether the concept is a verified resume attribute. Applies only when taxonomyConceptType is ATTRIBUTE.

customClasses [CustomTaxonomyClass!]! Non-Null

Custom classes the concept belongs to.

Example: "Cross-Occupational Cluster"

key ID! Non-Null

SUID of this custom class. Primary key.

uuid ID! Non-Null

UUID of this custom class. Prefer key instead.

label String! Non-Null

Preferred label of the custom class. English only, not localized.

taxonomyConceptType TaxonomyConceptType! Non-Null

Concept type.

isVerifiedJobAttribute Boolean! Non-Null

Whether the concept is a verified job attribute. Applies only when taxonomyConceptType is ATTRIBUTE.

isVerifiedResumeAttribute Boolean! Non-Null

Whether the concept is a verified resume attribute. Applies only when taxonomyConceptType is ATTRIBUTE.

responseStatus MdsResponseStatus! Non-Null

Response code and any errors.

responseCode MdsResponseCode! Non-Null

Response code from the Occupational Metadata API, following standard GraphQL codes.

errorMessage String

Error descriptions from the Occupational Metadata API.

Example

Query

query ClassifyOccupationsForJobDetails($input: ClassifyOccupationsForJobDetailsInput!) {
  classifyOccupationsForJobDetails(input: $input) {
    occupations {
      key
      uuid
      label
      alternativeLabels
      mobileLabel
      definitions
      pathToRoot {
        key
        uuid
        label
        alternativeLabels
        mobileLabel
        definitions
        pathToRoot {
          key
          uuid
          label
          alternativeLabels
          mobileLabel
          definitions
          pathToRoot {
            key
            uuid
            label
            alternativeLabels
            mobileLabel
            definitions
            pathToRoot {
              ...TaxonomyConceptFragment
            }
            children {
              ...TaxonomyConceptFragment
            }
            customClasses {
              ...CustomTaxonomyClassFragment
            }
            taxonomyConceptType
            isVerifiedJobAttribute
            isVerifiedResumeAttribute
          }
          children {
            key
            uuid
            label
            alternativeLabels
            mobileLabel
            definitions
            pathToRoot {
              ...TaxonomyConceptFragment
            }
            children {
              ...TaxonomyConceptFragment
            }
            customClasses {
              ...CustomTaxonomyClassFragment
            }
            taxonomyConceptType
            isVerifiedJobAttribute
            isVerifiedResumeAttribute
          }
          customClasses {
            key
            uuid
            label
          }
          taxonomyConceptType
          isVerifiedJobAttribute
          isVerifiedResumeAttribute
        }
        children {
          key
          uuid
          label
          alternativeLabels
          mobileLabel
          definitions
          pathToRoot {
            key
            uuid
            label
            alternativeLabels
            mobileLabel
            definitions
            pathToRoot {
              ...TaxonomyConceptFragment
            }
            children {
              ...TaxonomyConceptFragment
            }
            customClasses {
              ...CustomTaxonomyClassFragment
            }
            taxonomyConceptType
            isVerifiedJobAttribute
            isVerifiedResumeAttribute
          }
          children {
            key
            uuid
            label
            alternativeLabels
            mobileLabel
            definitions
            pathToRoot {
              ...TaxonomyConceptFragment
            }
            children {
              ...TaxonomyConceptFragment
            }
            customClasses {
              ...CustomTaxonomyClassFragment
            }
            taxonomyConceptType
            isVerifiedJobAttribute
            isVerifiedResumeAttribute
          }
          customClasses {
            key
            uuid
            label
          }
          taxonomyConceptType
          isVerifiedJobAttribute
          isVerifiedResumeAttribute
        }
        customClasses {
          key
          uuid
          label
        }
        taxonomyConceptType
        isVerifiedJobAttribute
        isVerifiedResumeAttribute
      }
      children {
        key
        uuid
        label
        alternativeLabels
        mobileLabel
        definitions
        pathToRoot {
          key
          uuid
          label
          alternativeLabels
          mobileLabel
          definitions
          pathToRoot {
            key
            uuid
            label
            alternativeLabels
            mobileLabel
            definitions
            pathToRoot {
              ...TaxonomyConceptFragment
            }
            children {
              ...TaxonomyConceptFragment
            }
            customClasses {
              ...CustomTaxonomyClassFragment
            }
            taxonomyConceptType
            isVerifiedJobAttribute
            isVerifiedResumeAttribute
          }
          children {
            key
            uuid
            label
            alternativeLabels
            mobileLabel
            definitions
            pathToRoot {
              ...TaxonomyConceptFragment
            }
            children {
              ...TaxonomyConceptFragment
            }
            customClasses {
              ...CustomTaxonomyClassFragment
            }
            taxonomyConceptType
            isVerifiedJobAttribute
            isVerifiedResumeAttribute
          }
          customClasses {
            key
            uuid
            label
          }
          taxonomyConceptType
          isVerifiedJobAttribute
          isVerifiedResumeAttribute
        }
        children {
          key
          uuid
          label
          alternativeLabels
          mobileLabel
          definitions
          pathToRoot {
            key
            uuid
            label
            alternativeLabels
            mobileLabel
            definitions
            pathToRoot {
              ...TaxonomyConceptFragment
            }
            children {
              ...TaxonomyConceptFragment
            }
            customClasses {
              ...CustomTaxonomyClassFragment
            }
            taxonomyConceptType
            isVerifiedJobAttribute
            isVerifiedResumeAttribute
          }
          children {
            key
            uuid
            label
            alternativeLabels
            mobileLabel
            definitions
            pathToRoot {
              ...TaxonomyConceptFragment
            }
            children {
              ...TaxonomyConceptFragment
            }
            customClasses {
              ...CustomTaxonomyClassFragment
            }
            taxonomyConceptType
            isVerifiedJobAttribute
            isVerifiedResumeAttribute
          }
          customClasses {
            key
            uuid
            label
          }
          taxonomyConceptType
          isVerifiedJobAttribute
          isVerifiedResumeAttribute
        }
        customClasses {
          key
          uuid
          label
        }
        taxonomyConceptType
        isVerifiedJobAttribute
        isVerifiedResumeAttribute
      }
      customClasses {
        key
        uuid
        label
      }
      taxonomyConceptType
      isVerifiedJobAttribute
      isVerifiedResumeAttribute
    }
    ancestors {
      key
      uuid
      label
      alternativeLabels
      mobileLabel
      definitions
      pathToRoot {
        key
        uuid
        label
        alternativeLabels
        mobileLabel
        definitions
        pathToRoot {
          key
          uuid
          label
          alternativeLabels
          mobileLabel
          definitions
          pathToRoot {
            key
            uuid
            label
            alternativeLabels
            mobileLabel
            definitions
            pathToRoot {
              ...TaxonomyConceptFragment
            }
            children {
              ...TaxonomyConceptFragment
            }
            customClasses {
              ...CustomTaxonomyClassFragment
            }
            taxonomyConceptType
            isVerifiedJobAttribute
            isVerifiedResumeAttribute
          }
          children {
            key
            uuid
            label
            alternativeLabels
            mobileLabel
            definitions
            pathToRoot {
              ...TaxonomyConceptFragment
            }
            children {
              ...TaxonomyConceptFragment
            }
            customClasses {
              ...CustomTaxonomyClassFragment
            }
            taxonomyConceptType
            isVerifiedJobAttribute
            isVerifiedResumeAttribute
          }
          customClasses {
            key
            uuid
            label
          }
          taxonomyConceptType
          isVerifiedJobAttribute
          isVerifiedResumeAttribute
        }
        children {
          key
          uuid
          label
          alternativeLabels
          mobileLabel
          definitions
          pathToRoot {
            key
            uuid
            label
            alternativeLabels
            mobileLabel
            definitions
            pathToRoot {
              ...TaxonomyConceptFragment
            }
            children {
              ...TaxonomyConceptFragment
            }
            customClasses {
              ...CustomTaxonomyClassFragment
            }
            taxonomyConceptType
            isVerifiedJobAttribute
            isVerifiedResumeAttribute
          }
          children {
            key
            uuid
            label
            alternativeLabels
            mobileLabel
            definitions
            pathToRoot {
              ...TaxonomyConceptFragment
            }
            children {
              ...TaxonomyConceptFragment
            }
            customClasses {
              ...CustomTaxonomyClassFragment
            }
            taxonomyConceptType
            isVerifiedJobAttribute
            isVerifiedResumeAttribute
          }
          customClasses {
            key
            uuid
            label
          }
          taxonomyConceptType
          isVerifiedJobAttribute
          isVerifiedResumeAttribute
        }
        customClasses {
          key
          uuid
          label
        }
        taxonomyConceptType
        isVerifiedJobAttribute
        isVerifiedResumeAttribute
      }
      children {
        key
        uuid
        label
        alternativeLabels
        mobileLabel
        definitions
        pathToRoot {
          key
          uuid
          label
          alternativeLabels
          mobileLabel
          definitions
          pathToRoot {
            key
            uuid
            label
            alternativeLabels
            mobileLabel
            definitions
            pathToRoot {
              ...TaxonomyConceptFragment
            }
            children {
              ...TaxonomyConceptFragment
            }
            customClasses {
              ...CustomTaxonomyClassFragment
            }
            taxonomyConceptType
            isVerifiedJobAttribute
            isVerifiedResumeAttribute
          }
          children {
            key
            uuid
            label
            alternativeLabels
            mobileLabel
            definitions
            pathToRoot {
              ...TaxonomyConceptFragment
            }
            children {
              ...TaxonomyConceptFragment
            }
            customClasses {
              ...CustomTaxonomyClassFragment
            }
            taxonomyConceptType
            isVerifiedJobAttribute
            isVerifiedResumeAttribute
          }
          customClasses {
            key
            uuid
            label
          }
          taxonomyConceptType
          isVerifiedJobAttribute
          isVerifiedResumeAttribute
        }
        children {
          key
          uuid
          label
          alternativeLabels
          mobileLabel
          definitions
          pathToRoot {
            key
            uuid
            label
            alternativeLabels
            mobileLabel
            definitions
            pathToRoot {
              ...TaxonomyConceptFragment
            }
            children {
              ...TaxonomyConceptFragment
            }
            customClasses {
              ...CustomTaxonomyClassFragment
            }
            taxonomyConceptType
            isVerifiedJobAttribute
            isVerifiedResumeAttribute
          }
          children {
            key
            uuid
            label
            alternativeLabels
            mobileLabel
            definitions
            pathToRoot {
              ...TaxonomyConceptFragment
            }
            children {
              ...TaxonomyConceptFragment
            }
            customClasses {
              ...CustomTaxonomyClassFragment
            }
            taxonomyConceptType
            isVerifiedJobAttribute
            isVerifiedResumeAttribute
          }
          customClasses {
            key
            uuid
            label
          }
          taxonomyConceptType
          isVerifiedJobAttribute
          isVerifiedResumeAttribute
        }
        customClasses {
          key
          uuid
          label
        }
        taxonomyConceptType
        isVerifiedJobAttribute
        isVerifiedResumeAttribute
      }
      customClasses {
        key
        uuid
        label
      }
      taxonomyConceptType
      isVerifiedJobAttribute
      isVerifiedResumeAttribute
    }
    responseStatus {
      responseCode
      errorMessage
    }
  }
}

Variables

{"input": ClassifyOccupationsForJobDetailsInput}

Response

{
  "data": {
    "classifyOccupationsForJobDetails": {
      "occupations": [TaxonomyConcept],
      "ancestors": [TaxonomyConcept],
      "responseStatus": MdsResponseStatus
    }
  }
}

 

Was this page helpful?