Job categories

Job categories

Job categories identify the occupational category of a position. Properly categorising positions helps candidates search for the most relevant jobs. They are also used as an input into SEEK’s ad pricing.
Job categories are represented as a hierarchy from a general parent category to more specific child categories. For example, the parent category might be “Information & Communication Technology” with a child of “Engineering - Software”. In SEEK ANZ the hierarchy has two levels corresponding to SEEK ANZ’s classification and subclassification.

Before you begin

  • SEEK recommends using a browser token to query job categories directly from a hirer’s browser. For the browser token to work, you will need to include the query:ontologies scope in your request.
  • You can also query job categories from your backend using a partner token.

Operations

The SEEK API provides three queries for looking up job categories:
  1. jobCategorySuggestions will suggest job categories based on a partial PositionProfile .
  2. jobCategories will return the top-level categories for a scheme. You can use this as a starting point for selecting a specific child category.
  3. jobCategory returns the job category for a given ID.

jobCategorySuggestions

The jobCategorySuggestions query returns an array of suggested job categories based on a partial PositionProfile .
While only the position’s title is required, providing more fields will increase the relevance of the suggestions. This can be used to interactively suggest job categories to a hirer while they’re creating a new PositionProfile.
QueryVariablesResult
query(
  $positionProfile: JobCategorySuggestionPositionProfileInput!
  $schemeId: String!
  $first: Int
) {
  jobCategorySuggestions(
    positionProfile: $positionProfile
    schemeId: $schemeId
    first: $first
  ) {
    jobCategory {
      id {
        value
      }
      name
      parent {
        id {
          value
        }
        name
      }
    }
    confidence
  }
}

jobCategories

The jobCategories query returns an array of top-level job categories for a given scheme. These represent the most general job categories in the scheme’s hierarchy.
You can use the top-level categories as a starting point for drilling down to a specific child category. For example, you might present the hirer with a dropdown of top-level categories that populates a second dropdown with its children.
QueryVariablesResult
query($schemeId: String!) {
  jobCategories(schemeId: $schemeId) {
    id {
      value
    }
    name
    children {
      id {
        value
      }
      name
    }
  }
}

jobCategory

The jobCategory query retrieves a job category by ID. This can be useful for debugging or exploratory testing:
QueryVariablesResult
query($id: String!) {
  jobCategory(id: $id) {
    id {
      value
    }
    parent {
      id {
        value
      }
      name
    }
    name
    children {
      id {
        value
      }
      name
    }
  }
}
Ad selection
Job Posting
Job Posting