SteveSignalsDocs
EN日本語

イベントリファレンス

求人イベント

競合の求人の Webhook イベント。すべてのキー、更新時の変更の入り方、新規・更新・終了のサンプルボディを紹介します。

求人イベントは、トラッキング中の競合が求人を公開したとき、求人の主要な項目を変更したとき、求人を終了したときに発生します。1 つの求人につき、変更のたびに 1 つのイベントです。

eventType
jobs
subEventType
job_posting
signalType
新しい求人は jobs.new（action: "new"）、主要な項目が変わったときは jobs.updated（action: "updated"）、求人が終了したときは jobs.removed（action: "removed"）
プラットフォームフィールド
jobResponse（metadata と同じ値）
トラッカー
求人
relevance
常に { "status": "unjudged" }：求人は見つかったまま届きます

このページの読み方

求人のボディはすべて、共通フィールドと、jobResponse オブジェクト 1 つ（metadata としても送信）で構成されます。このオブジェクトには、アイテム項目と、下記の求人の項目が入ります。platform キーはありません。itemKey は、Webhook では job_postings-<jobId>、Pull API では job_postings|<jobId> の形です。

フィールド

jobResponse
title
string
求人のタイトル。
text
string|null
本文。ボードが提供している場合のみ入ります。null のこともあります。
url
string|null
求人ページへの公開リンク。
author
object|null
求人では通常 null です。
media
object[]
{ type: 'image' | 'video' | 'document', url: string }。通常は空です。
metrics
object|null
求人では通常 null です。
status
'open'|'closed'
jobs.new と jobs.updated では open。jobs.removed では closed。
jobId
string
ボード上の求人 ID。イベントをまたいで変わりません。
atsType
string
求人を読み取ったボード。たとえば greenhouse、lever、careers_page、google_jobs。開いた値として扱ってください。新しいボードは、バージョンを変えずに追加されます。
boardUrl
string|null
求人ボードの URL。
department
string|null
部門（ボードでの呼び名のまま）。
team
string|null
チーム（ボードでの呼び名のまま）。
category
string|null
職種カテゴリー。Signals が決まった 14 個の値から割り当てます: engineering、product、design、data、research、sales、marketing、customer_success、operations、finance、legal、people、it_security、other。ボード自身の呼び名ではありません。AI の分類器が、職種名と部門から選びます。分類できなかった場合は null です。ボードでの呼び名は department をご覧ください。
locations
object[]
勤務地：{ raw: string, countryCode: string | null }。raw はボード上の文字列です。countryCode は、Signals が判別できた場合の ISO 国コードです。一度判別できた勤務地は、以降のチェックでも同じ countryCode を保ちます。空の配列のこともあります。
workplaceType
'remote'|'hybrid'|'onsite'|null
働く場所の形態。
employmentType
'full_time'|'part_time'|'contract'|'intern'|'temporary'|null
雇用形態。
postedAt
string|null
求人が公開された日時（ISO 8601）。ボードが示している場合のみ入ります。
applyUrl
string|null
応募先の URL。
salary
object|null
給与レンジ：{ min: number | null, max: number | null, currency: string | null, period: string | null, raw: string | null }。給与の記載がない求人では null です。
changes
object[]
変更内容。jobs.updated のときだけ値が入ります。jobs.new と jobs.removed では [] です。

何が更新として扱われるか

次のフィールドのどれかが変わると、jobs.updated が発生します：title、department、team、locations、workplaceType、employmentType、salary。説明文、category、日付（postedAt）、リンク（url、applyUrl、boardUrl）が変わっても発生しません。changes の各エントリーの形は次のとおりです。

changes[] · 1 つのフィールドの変更
field
'title'|'department'|'team'|'locations'|'workplaceType'|'employmentType'|'salary'
変更されたフィールド。
before
string|null
変更前の値（表示用テキスト）。未設定だった場合は null。
after
string|null
現在の値（表示用テキスト）。削除された場合は null。

jobResponse のほかの項目には、新しい値が入ります。

新しい求人

jobs.new は、前回のチェックで公開されていなかった求人に対して発生します。最初のチェックでは、その時点で公開中のすべての求人が jobs.new として送られます。 大企業では、1 回のチェックで数千件のイベントになることがあります。

イベント · job_posting、新規（Acme）正確な形のサンプル（実データはまだありません）
json
1{
2  "version": 1,
3  "eventId": "3f1c9a52-6b0e-4c3a-9d41-0a7d2b8e5f10",
4  "eventType": "jobs",
5  "subEventType": "job_posting",
6  "action": "new",
7  "signalType": "jobs.new",
8  "source": "job_postings",
9  "orgId": "org_3KikADUjsyXrUJ4RJhWpwcp98Yf",
10  "trackerId": "b13a7c58-02d4-4e9f-8a61-5f3c9e0d2b74",
11  "projectId": "2738158a-08fd-4fc4-912d-43d4c328bc10",
12  "runId": "5d2f7a14-9c3b-4e68-8f21-b7c4a0e19d36",
13  "competitor": {
14    "name": "Acme",
15    "domain": "acme.com",
16    "subjectKey": "jobs:acme.com"
17  },
18  "occurredAt": "2026-10-27T09:12:00.000Z",
19  "detectedAt": "2026-10-28T06:03:11.482Z",
20  "sequence": 301,
21  "itemKey": "job_postings-7421035",
22  "relevance": {
23    "status": "unjudged"
24  },
25  "jobResponse": {
26    "title": "Senior Product Marketing Manager",
27    "text": "Acme is hiring a Senior Product Marketing Manager to own positioning and launches for our analytics platform. You will work with product, sales and customer success to bring new features to market.",
28    "url": "https://boards.greenhouse.io/acme/jobs/7421035",
29    "author": null,
30    "media": [],
31    "metrics": null,
32    "status": "open",
33    "jobId": "7421035",
34    "atsType": "greenhouse",
35    "boardUrl": "https://boards.greenhouse.io/acme",
36    "department": "Marketing",
37    "team": "Product Marketing",
38    "category": "marketing",
39    "locations": [
40      {
41        "raw": "San Francisco, CA",
42        "countryCode": "US"
43      }
44    ],
45    "workplaceType": "hybrid",
46    "employmentType": "full_time",
47    "postedAt": "2026-10-27T09:12:00.000Z",
48    "applyUrl": "https://boards.greenhouse.io/acme/jobs/7421035",
49    "salary": {
50      "min": 170000,
51      "max": 210000,
52      "currency": "USD",
53      "period": "year",
54      "raw": "$170,000 - $210,000"
55    },
56    "changes": []
57  },
58  "metadata": {
59    "title": "Senior Product Marketing Manager",
60    "text": "Acme is hiring a Senior Product Marketing Manager to own positioning and launches for our analytics platform. You will work with product, sales and customer success to bring new features to market.",
61    "url": "https://boards.greenhouse.io/acme/jobs/7421035",
62    "author": null,
63    "media": [],
64    "metrics": null,
65    "status": "open",
66    "jobId": "7421035",
67    "atsType": "greenhouse",
68    "boardUrl": "https://boards.greenhouse.io/acme",
69    "department": "Marketing",
70    "team": "Product Marketing",
71    "category": "marketing",
72    "locations": [
73      {
74        "raw": "San Francisco, CA",
75        "countryCode": "US"
76      }
77    ],
78    "workplaceType": "hybrid",
79    "employmentType": "full_time",
80    "postedAt": "2026-10-27T09:12:00.000Z",
81    "applyUrl": "https://boards.greenhouse.io/acme/jobs/7421035",
82    "salary": {
83      "min": 170000,
84      "max": 210000,
85      "currency": "USD",
86      "period": "year",
87      "raw": "$170,000 - $210,000"
88    },
89    "changes": []
90  }
91}

更新された求人

イベント · job_posting、更新（Acme）正確な形のサンプル（実データはまだありません）
json
1{
2  "version": 1,
3  "eventId": "a84e2d17-35fb-4b09-b6c2-61e9d07c3a48",
4  "eventType": "jobs",
5  "subEventType": "job_posting",
6  "action": "updated",
7  "signalType": "jobs.updated",
8  "source": "job_postings",
9  "orgId": "org_3KikADUjsyXrUJ4RJhWpwcp98Yf",
10  "trackerId": "b13a7c58-02d4-4e9f-8a61-5f3c9e0d2b74",
11  "projectId": "2738158a-08fd-4fc4-912d-43d4c328bc10",
12  "runId": "e90b13c6-72aa-4d85-a1f4-3c58b9d20e77",
13  "competitor": {
14    "name": "Acme",
15    "domain": "acme.com",
16    "subjectKey": "jobs:acme.com"
17  },
18  "occurredAt": "2026-10-28T06:02:40.215Z",
19  "detectedAt": "2026-10-28T06:02:40.215Z",
20  "sequence": 318,
21  "itemKey": "job_postings-7421035",
22  "relevance": {
23    "status": "unjudged"
24  },
25  "jobResponse": {
26    "title": "Senior Product Marketing Manager",
27    "text": "Acme is hiring a Senior Product Marketing Manager to own positioning and launches for our analytics platform. You will work with product, sales and customer success to bring new features to market.",
28    "url": "https://boards.greenhouse.io/acme/jobs/7421035",
29    "author": null,
30    "media": [],
31    "metrics": null,
32    "status": "open",
33    "jobId": "7421035",
34    "atsType": "greenhouse",
35    "boardUrl": "https://boards.greenhouse.io/acme",
36    "department": "Marketing",
37    "team": "Product Marketing",
38    "category": "marketing",
39    "locations": [
40      {
41        "raw": "San Francisco, CA",
42        "countryCode": "US"
43      },
44      {
45        "raw": "Remote, United States",
46        "countryCode": "US"
47      }
48    ],
49    "workplaceType": "remote",
50    "employmentType": "full_time",
51    "postedAt": "2026-10-27T09:12:00.000Z",
52    "applyUrl": "https://boards.greenhouse.io/acme/jobs/7421035",
53    "salary": {
54      "min": 180000,
55      "max": 220000,
56      "currency": "USD",
57      "period": "year",
58      "raw": "$180,000 - $220,000"
59    },
60    "changes": [
61      {
62        "field": "workplaceType",
63        "before": "hybrid",
64        "after": "remote"
65      },
66      {
67        "field": "locations",
68        "before": "San Francisco, CA",
69        "after": "San Francisco, CA; Remote, United States"
70      },
71      {
72        "field": "salary",
73        "before": "$170,000 - $210,000",
74        "after": "$180,000 - $220,000"
75      }
76    ]
77  },
78  "metadata": {
79    "title": "Senior Product Marketing Manager",
80    "text": "Acme is hiring a Senior Product Marketing Manager to own positioning and launches for our analytics platform. You will work with product, sales and customer success to bring new features to market.",
81    "url": "https://boards.greenhouse.io/acme/jobs/7421035",
82    "author": null,
83    "media": [],
84    "metrics": null,
85    "status": "open",
86    "jobId": "7421035",
87    "atsType": "greenhouse",
88    "boardUrl": "https://boards.greenhouse.io/acme",
89    "department": "Marketing",
90    "team": "Product Marketing",
91    "category": "marketing",
92    "locations": [
93      {
94        "raw": "San Francisco, CA",
95        "countryCode": "US"
96      },
97      {
98        "raw": "Remote, United States",
99        "countryCode": "US"
100      }
101    ],
102    "workplaceType": "remote",
103    "employmentType": "full_time",
104    "postedAt": "2026-10-27T09:12:00.000Z",
105    "applyUrl": "https://boards.greenhouse.io/acme/jobs/7421035",
106    "salary": {
107      "min": 180000,
108      "max": 220000,
109      "currency": "USD",
110      "period": "year",
111      "raw": "$180,000 - $220,000"
112    },
113    "changes": [
114      {
115        "field": "workplaceType",
116        "before": "hybrid",
117        "after": "remote"
118      },
119      {
120        "field": "locations",
121        "before": "San Francisco, CA",
122        "after": "San Francisco, CA; Remote, United States"
123      },
124      {
125        "field": "salary",
126        "before": "$170,000 - $210,000",
127        "after": "$180,000 - $220,000"
128      }
129    ]
130  }
131}

終了した求人

jobs.removed は、すべてのボードを完全に読み取った結果、求人が見つからなくなったときに発生します。ボディには、求人の最後に確認できた値が status: "closed" とともに入り、jobResponse は null ではありません。ボードを最後まで読み取れなかったときは、削除は送信されません。

イベント · job_posting、終了（Acme）正確な形のサンプル（実データはまだありません）
json
1{
2  "version": 1,
3  "eventId": "c27d5b90-18ea-4f36-a0d3-94b6e1f72c05",
4  "eventType": "jobs",
5  "subEventType": "job_posting",
6  "action": "removed",
7  "signalType": "jobs.removed",
8  "source": "job_postings",
9  "orgId": "org_3KikADUjsyXrUJ4RJhWpwcp98Yf",
10  "trackerId": "b13a7c58-02d4-4e9f-8a61-5f3c9e0d2b74",
11  "projectId": "2738158a-08fd-4fc4-912d-43d4c328bc10",
12  "runId": "0b6e48d2-a5c7-4139-9e8f-d2a71c35b690",
13  "competitor": {
14    "name": "Acme",
15    "domain": "acme.com",
16    "subjectKey": "jobs:acme.com"
17  },
18  "occurredAt": "2026-10-29T06:01:52.903Z",
19  "detectedAt": "2026-10-29T06:01:52.903Z",
20  "sequence": 341,
21  "itemKey": "job_postings-7421035",
22  "relevance": {
23    "status": "unjudged"
24  },
25  "jobResponse": {
26    "title": "Senior Product Marketing Manager",
27    "text": null,
28    "url": "https://boards.greenhouse.io/acme/jobs/7421035",
29    "author": null,
30    "media": [],
31    "metrics": null,
32    "status": "closed",
33    "jobId": "7421035",
34    "atsType": "greenhouse",
35    "boardUrl": "https://boards.greenhouse.io/acme",
36    "department": "Marketing",
37    "team": "Product Marketing",
38    "category": "marketing",
39    "locations": [
40      {
41        "raw": "San Francisco, CA",
42        "countryCode": "US"
43      },
44      {
45        "raw": "Remote, United States",
46        "countryCode": "US"
47      }
48    ],
49    "workplaceType": "remote",
50    "employmentType": "full_time",
51    "postedAt": "2026-10-27T09:12:00.000Z",
52    "applyUrl": "https://boards.greenhouse.io/acme/jobs/7421035",
53    "salary": {
54      "min": 180000,
55      "max": 220000,
56      "currency": "USD",
57      "period": "year",
58      "raw": "$180,000 - $220,000"
59    },
60    "changes": []
61  },
62  "metadata": {
63    "title": "Senior Product Marketing Manager",
64    "text": null,
65    "url": "https://boards.greenhouse.io/acme/jobs/7421035",
66    "author": null,
67    "media": [],
68    "metrics": null,
69    "status": "closed",
70    "jobId": "7421035",
71    "atsType": "greenhouse",
72    "boardUrl": "https://boards.greenhouse.io/acme",
73    "department": "Marketing",
74    "team": "Product Marketing",
75    "category": "marketing",
76    "locations": [
77      {
78        "raw": "San Francisco, CA",
79        "countryCode": "US"
80      },
81      {
82        "raw": "Remote, United States",
83        "countryCode": "US"
84      }
85    ],
86    "workplaceType": "remote",
87    "employmentType": "full_time",
88    "postedAt": "2026-10-27T09:12:00.000Z",
89    "applyUrl": "https://boards.greenhouse.io/acme/jobs/7421035",
90    "salary": {
91      "min": 180000,
92      "max": 220000,
93      "currency": "USD",
94      "period": "year",
95      "raw": "$180,000 - $220,000"
96    },
97    "changes": []
98  }
99}

Pull API では、同じイベントが source: "job_postings" となり、detail に求人の項目が入ります。Pull API をご覧ください。

signal.v1 · jobs.new正確な形のサンプル（実データはまだありません）
json
1{
2  "schema": "signal.v1",
3  "type": "jobs.new",
4  "id": "3f1c9a52-6b0e-4c3a-9d41-0a7d2b8e5f10",
5  "orgId": "org_3KikADUjsyXrUJ4RJhWpwcp98Yf",
6  "trackerId": "b13a7c58-02d4-4e9f-8a61-5f3c9e0d2b74",
7  "runId": "5d2f7a14-9c3b-4e68-8f21-b7c4a0e19d36",
8  "source": "job_postings",
9  "subject": {
10    "key": "jobs:acme.com",
11    "display": "Acme"
12  },
13  "change": "added",
14  "changeSeq": 301,
15  "itemKey": "job_postings|7421035",
16  "observedAt": "2026-10-27T09:12:00.000Z",
17  "detectedAt": "2026-10-28T06:03:11.482Z",
18  "item": {
19    "title": "Senior Product Marketing Manager",
20    "text": "Acme is hiring a Senior Product Marketing Manager to own positioning and launches for our analytics platform. You will work with product, sales and customer success to bring new features to market.",
21    "url": "https://boards.greenhouse.io/acme/jobs/7421035",
22    "author": null,
23    "metrics": null,
24    "media": []
25  },
26  "detail": {
27    "source": "job_postings",
28    "kind": "job",
29    "status": "open",
30    "jobId": "7421035",
31    "atsType": "greenhouse",
32    "boardUrl": "https://boards.greenhouse.io/acme",
33    "title": "Senior Product Marketing Manager",
34    "department": "Marketing",
35    "team": "Product Marketing",
36    "category": "marketing",
37    "locations": [
38      {
39        "raw": "San Francisco, CA",
40        "countryCode": "US"
41      }
42    ],
43    "workplaceType": "hybrid",
44    "employmentType": "full_time",
45    "postedAt": "2026-10-27T09:12:00.000Z",
46    "applyUrl": "https://boards.greenhouse.io/acme/jobs/7421035",
47    "salary": {
48      "min": 170000,
49      "max": 210000,
50      "currency": "USD",
51      "period": "year",
52      "raw": "$170,000 - $210,000"
53    },
54    "changes": []
55  },
56  "relevance": {
57    "status": "unjudged"
58  }
59}
求人トラッカー

頻度、費用、求人の見つけ方。

イベントタイプ一覧

すべての名前を 1 つの表で確認できます。

前へ
Web ページの変更
次へ
新しい競合