SUIDs(Short Unique Identifiers)について
求人と採用企業を、種別・職種・属性ごとに分類する標準化された5文字のコードです。
概要
SUIDとは、求人や採用企業を分類するための5文字の英数字コードです。
SUIDの用途:
- 雇用形態の指定(正社員、パート、契約社員 など)
- 職種の分類(ソフトウェアエンジニア、看護師、会計士 など)
- 勤務形態や検索属性の指定(フレックスタイム、シフト制、リモートワーク など)
- 採用企業の業種・業界の分類
SUIDの設定箇所
Job Sync API
Job Sync API(求人連携API)で求人投稿の作成や更新を行う際は、SourcedJobPostingTaxonomyInputでSUIDを指定します。
jobTypes: 雇用形態のSUIDoccupations: 職種のSUIDattributes: 勤務形態と検索属性のSUID
Employer Data API
Employer Data API(採用企業データAPI)で採用企業データの作成や更新を行う際は、CountrySpecificEmployerAttributesInputでSUIDを指定します。
sectorSUIDs: 採用企業の業種SUID(最大3個)
使用例
例:日本のフレックスタイム制パートタイムソフトウェアエンジニアの求人
mutation CreateJobPosting { jobsIngest { createSourcedJobPostings(input: { jobPostings: [{ body: { title: "Software Engineer" description: "<p>Join our team...</p>" location: { country: "JP" streetAddress: "Tokyo, Shibuya" } } metadata: { jobSource: { companyName: "Example Company" sourceName: "example-source" sourceType: "Employer" } jobPostingId: "job-123" datePublished: "2026-01-14T12:00:00Z" url: "https://example.com/jobs/123" taxonomyClassification: { jobTypes: ["75GKK"] # パートタイム occupations: ["NP8BZ"] # ソフトウェアエンジニア attributes: ["HY5VT"] # フレックスタイム } } }] }) { results { jobPosting { sourcedPostingId } } } }}有効なSUIDの検索
有効なSUIDは、以下のガイドに掲載されています。
-
SUIDリファレンス(全テーブル) - すべてのSUIDテーブルを1ページにまとめています。Ctrl+FまたはCmd+Fで検索してください。
-
Job Sync API リファレンス:
- 雇用形態: 雇用形態(正社員、パート、契約社員)のSUID
- 職種: カテゴリー別の職種SUID
- 勤務形態: 勤務スケジュールや勤務体系のSUID
- 検索属性: スキル・福利厚生・求人特徴のSUID
- シフトとスケジュール: シフトパターンのSUID
-
Employer Data API リファレンス:
- 採用企業の業種: 採用企業の業種SUID
Job Sync API リファレンス
- 雇用形態: 雇用形態(正社員、パート、契約社員)のSUID
- 職種: カテゴリー別の職種SUID
- 勤務形態: 勤務スケジュールや勤務体系のSUID
- 検索属性: スキル・福利厚生・求人特徴のSUID
- シフトとスケジュール: シフトパターンのSUID