GET /jobs
source-native 求人行を検索し、会社情報を後から紐付ける API です。
このページの内容7項目
GET /api/signal-foundry/jobs は求人行起点の検索です。会社カードを先に読む companies とは違い、まず個別の求人を返し、リンク済みのものだけ company を添えます。
契約サマリー
| 項目 | 値 |
|---|---|
| Method | GET |
| Path | /api/signal-foundry/jobs |
| Auth | production は API key 必須 |
| Credit | 1 request credit / operation credit 0 |
| CLI | sf job search <query> --json |
| Grain | one row per source-native job posting |
リクエスト
curl -s \ -H "Authorization: Bearer <SIGNAL_FOUNDRY_API_KEY>" \ "https://signal-foundry.app/api/signal-foundry/jobs?q=大阪勤務のAI求人&limit=10"
クエリパラメータ
| パラメータ | 型 | 既定値 | 備考 |
|---|---|---|---|
q | string | null | 求人タイトル、source-native 会社名、自然文 |
ai_jobs | boolean | null | true でタイトルに AI を含む求人に絞る |
job_location | array | [] | 求人勤務地。大阪 などの部分一致 |
prefecture | array | [] | リンク済み Base 会社所在地。求人勤務地ではない |
manufacturing | boolean | null | true で製造業の linked company context に絞る |
industry_33_code | array | [] | リンク済み Base 会社の JPX 33 業種コード |
company_id | string | null | リンク済みの company_id |
company_name | string | null | source-native 会社名 |
first_seen_after | date | null | Signal Foundry が初回観測した日。新着求人だけ追う用途 |
last_seen_after | date | null | 直近観測日。更新後にまだ見えている求人を追う用途 |
posted_after | date | null | 求人票の掲載日 |
source | array | [] | 求人媒体の source |
status | string | active | active / missing / closed / all |
linked | boolean | null | true で Base 会社リンク済み求人だけ |
unlinked | boolean | null | true で未リンク求人だけ |
order | string | newest | newest / posted / salary / company / source |
limit | integer | 20 | 1..100 |
offset | integer | 0 | 0..10000 |
q=大阪勤務のAI求人 のように「勤務」が入る場合、大阪 は job_location として解釈されます。会社所在地で絞る場合は prefecture=大阪府 を明示します。
order=newest は last_seen_at、date_posted の順で新しい求人を優先します。order=posted は求人票の date_posted を優先します。どちらも同順位の場合は company_id で並び順を決めます。
レスポンス
まず見る key:
jobs[].job_posting_idjobs[].titlejobs[].locationsjobs[].company_link.company_idjobs[].company.display_namegaps[]actions[]meta.matched_postingsmeta.matched_postings_kindmeta.returned_postings
{
"jobs": [
{
"job_posting_id": "green_xxx",
"source": "green",
"title": "AIエンジニア",
"locations": ["大阪府"],
"company_link": {
"company_id": "company_123",
"match_status": "matched"
},
"company": {
"company_id": "company_123",
"display_name": "サンプル株式会社",
"prefecture": "大阪府",
"industry_33_code": "3650"
}
}
],
"meta": {
"matched_postings": 749,
"matched_postings_kind": "planner_estimate",
"returned_postings": 10
},
"gaps": [],
"actions": []
}
求人数の読み方
meta.matched_postings は、meta.matched_postings_kind と組み合わせて読みます。
matched_postings_kind | 意味 | 例 |
|---|---|---|
exact | 確定総数。短いページの offset + returned_postings から確定します | 47 は47件 |
planner_estimate | planner が返した推定総数 | 749 は約749件 |
lower_bound | 満杯ページで確認できた下限 | 60 は60件以上 |
unknown | source が未配置で総数不明 | 0 は0件ではなく件数不明 |
{
"meta": {
"matched_postings": 60,
"matched_postings_kind": "lower_bound",
"offset": 40,
"returned_postings": 20
}
}
offset > 0 の空ページは総数を確定できません。planner_estimate のまま返り、gaps[] に job_search_count_estimate_returned_no_rows が入ります。unknown の場合は job_search_source_pending を確認し、0件と解釈しないでください。
0 件で gaps[] がある場合は、求人が存在しない証明ではありません。status=all、job_location、prefecture、ai_jobs の分解、または sf search <query> --json で会社起点に戻します。
CLI での実行
sf job search "大阪勤務のAI求人" --json sf job search "直近7日の新着AI求人" --json sf job search "新着AI求人" --first-seen-after 2026-05-20 --json sf job search "AI求人" --ai-jobs true --job-location 大阪 --json sf job search "大阪の製造業求人" --prefecture 大阪府 --manufacturing true --json
会社候補にまとめる場合は、この endpoint の company_link.company_id をローカルの表にし、必要な会社だけ sf company <companyId> --json に渡します。
更新運用では、初回全量反映後は first_seen_after で新着求人だけ、status=missing/closed で消えた求人だけを追えます。会社側の採用強度は sf search --has-jobs true や active_job_count / newest_active_job_seen_at の会社列で見ます。個別求人の新着確認は、この /jobs surface で見ます。
エラー
limit は 1..100、offset は 0..10000 の範囲で指定します。認証に失敗した場合は 401、入力が不正な場合は 400、検索処理に失敗した場合は 500 を返します。自然文から意図した絞り込みにならない場合は、ai_jobs=true、job_location=大阪、prefecture=大阪府、manufacturing=true のように構造化パラメータを明示して再実行してください。