Hirer identifiers

    Suggestions will appear below the field as you type

    Hirer identifiers

      Suggestions will appear below the field as you type

      Hirer identifiers

      Hirer identifiers

      The SEEK API uses opaque object identifier strings to identify SEEK hirers. Your software can programmatically convert between our numeric SEEK advertiser IDs and the new hirer IDs. However, you’re encouraged to directly use hirer IDs whenever possible.
      The “Look up a hirer by ID” section of the Developer Dashboard’s hirers page  can search for a hirer by either identifier. You can then view all of their identifiers along with their active relationships.

      Converting from a SEEK advertiser ID

      The seekAnzAdvertiser query  looks up a HiringOrganization  from a SEEK advertiser ID. You can select the resulting HiringOrganization’s hirer ID:
      QueryVariablesResult
      query ($legacyId: Int!) {
        seekAnzAdvertiser(id: $legacyId) {
          id {
            value
          }
        }
      }
      The hiringOrganizations query  will return a paginated list of all the SEEK hirers you have a relationship with. You can select both the id & seekAnzAdvertiserId fields to produce a mapping between the identifiers:
      QueryVariablesResult
      query ($schemeId: String!, $first: Int) {
        hiringOrganizations(schemeId: $schemeId, first: $first) {
          edges {
            node {
              id {
                value
              }
              seekAnzAdvertiserId
              name
            }
          }
          pageInfo {
            hasNextPage
            endCursor
          }
        }
      }

      Selecting an object’s SEEK advertiser ID

      HiringOrganization objects have a seekAnzAdvertiserId field  that will be set for SEEK ANZ hirers.
      For example, you can select the SEEK advertiser ID that posted a given PositionProfile :
      QueryVariablesResult
      query ($id: String!) {
        positionProfile(id: $id) {
          positionOrganizations {
            seekAnzAdvertiserId
          }
        }
      }

      Converting to a SEEK advertiser ID

      You can directly convert a hirer ID to a SEEK advertiser ID using the hiringOrganization query . This can be useful for exploratory testing or debugging:
      QueryVariablesResult
      query ($id: String!) {
        hiringOrganization(id: $id) {
          seekAnzAdvertiserId
          name
        }
      }