GET /jobs
source-native 求人行を検索し、会社情報を後から紐付ける API を説明します。
このページの内容6項目
GET /api/signal-foundry/jobs は求人行起点の検索です。会社リストを先に作る companies / lists とは違い、まず個別の求人を返し、リンク済みのものだけ company を添えます。
契約サマリー
| Field | Value |
|---|---|
| Method | GET |
| Path | /api/signal-foundry/jobs |
| Auth | production は API key 必須 |
| Credit | data クレジットは消費しない |
| 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"
クエリパラメータ
| Param | Type | Default | Notes |
|---|---|---|---|
q | string | null | 求人タイトル、source 会社名、自然文 |
ai_jobs | boolean | null | true で AI title 求人に絞る |
job_location | array | [] | 求人勤務地。大阪 などの部分一致 |
prefecture | array | [] | リンク済み Base 会社所在地。求人勤務地ではない |
manufacturing | boolean | null | true で製造業の linked company context に絞る |
industry_33_code | array | [] | linked company の JPX 33 業種コード |
company_id | string | null | linked 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 | [] | job board 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 を優先します。どちらも同順位の tie-breaker として company_id を使います。
レスポンス
まず見る key:
jobs[].job_posting_idjobs[].titlejobs[].locationsjobs[].company_link.company_idjobs[].company.display_namemeta.matched_postingsmeta.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,
"returned_postings": 10
}
}
CLI equivalent
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
会社リストを作る場合は sf list create "大阪の製造業で求人を募集している会社" --json を使います。求人行を見てから会社に進む場合は、この endpoint の company_link.company_id を sf company profile <companyId> --json に渡します。
更新運用では、初回全量反映後は first_seen_after で新着求人だけ、status=missing/closed で消えた求人だけを追えます。会社側の採用強度は company 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 のように構造化パラメータを明示して再実行してください。