SUIDを理解する

Indeed APIで求人や雇用主を分類するために、短縮一意識別子（SUID）を使用します。

 

概要

短縮一意識別子（SUID）は、求人や雇用主の分類方法を標準化する5文字の英数字コードです。

SUIDは次の用途で使用します。

• 雇用形態の指定（正社員、パートタイム、契約社員）
• 職種の分類（ソフトウェアエンジニア、看護師、会計士）
• 勤務形態と求人属性の定義（フレックスタイム、シフト勤務、リモート）
• 雇用主のセクターと業界の分類

SUIDの使用箇所

Job Sync API

Job Sync APIで求人を作成または更新する際は、SourcedJobPostingTaxonomyInputでSUIDを指定します。

• jobTypes：雇用形態のSUID
• occupations：職種のSUID
• attributes：勤務形態と検索属性のSUID

Employer Data API

Employer Data 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"]        # Part-time
            occupations: ["NP8BZ"]     # Software engineer
            attributes: ["HY5VT"]      # Flextime
          }
        }
      }]
    }) {
      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

Employer Data APIリファレンス

• 企業セクター：雇用主の業界のSUID

SUIDの形式

SUIDは次の形式に従います。

• 長さ：5文字
• 値：大文字・小文字を区別する英数字（文字と数字）
• 例：75GKK、C3XKZ、7SRRR

国別の要件

日本

日本の求人投稿では、次のSUIDを使用します。

• 雇用形態（すべての求人投稿で必須）
• 職種（すべての求人投稿で必須）
• 勤務形態（任意、推奨）
• 企業セクター（雇用主の作成時に必須）

日本の求人投稿ガイドラインと例をご覧ください。

その他の国

日本以外では、SUIDは任意です。ほとんどのタクソノミーフィールドは自由形式のテキストを受け付けますが、SUIDを使用すると求人の表示性とマッチングが向上します。

ベストプラクティス

SUIDのガイドラインは次のとおりです。

• リファレンスをブックマークしてください。
• リファレンスにあるSUIDのみを使用してください。独自に作成や変更はしないでください。
• 対象国で有効なSUIDを使用してください。
• 求人が複数のカテゴリに該当する場合は、複数のSUIDを使用してください。
• 上限を遵守してください（企業セクターは3つまでなど）。

一般的な問題

無効なSUIDのエラー

SUIDバリデーションエラーが発生した場合は、次を確認します。

1. リファレンスでSUIDを確認します。
2. タイプミスと大文字・小文字を確認します。
3. SUIDが対象国で有効か確認します。
4. SUIDが正しいフィールドにあるか確認します。

必須SUIDの不足

日本の求人投稿には、次が必要です。

• jobTypesに少なくとも1つの雇用形態SUID
• occupationsに少なくとも1つの職種SUID
• sectorSUIDsに少なくとも1つの企業セクターSUID（雇用主のみ）

GraphQLエラーのトラブルシューティングをご覧ください。

関連リソース

• SUID変更履歴：SUIDリファレンステーブルへの追加、削除、修正を追跡します。
• Job Sync APIガイド
• Employer Data API
• GraphQL at Indeed

 

このページは役に立ちましたか？