求人詳細本文検索

セールスブレインでは、求人タイトルだけでなく求人詳細本文のキーワードでも企業・求人を検索できます。Webアプリでは「求人詳細」フィルター、APIでは以下の検索条件を利用します。

検索対象

求人詳細本文検索の対象は、セールスブレインが直近1か月に取得した求人詳細本文です。すべての過去求人が対象ではありません。

検索結果の descriptionSnippets には、一致箇所ごとの抜粋が配列で返ります（最大5件）。キーワード検索時は一致語が <mark> タグで囲まれます。本文全体が必要な場合は、検索結果の id を使って GET /jobs/{jobId}/detail を呼び出します。

検索条件

POST /jobs/searchでは該当求人を、POST /corporates/searchでは該当求人を持つ企業を返します。

求人を検索する

curl -s "$SALESBRAIN_API_BASE_URL/jobs/search" \
  -H "X-API-Key: $SALESBRAIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "filters": {
      "jobDescription": {
        "anyContains": ["Salesforce", "HubSpot"],
        "noneContains": ["募集終了"]
      }
    },
    "limit": 10,
    "offset": 0,
    "includeTotalResults": true
  }'

企業を検索する

curl -s "$SALESBRAIN_API_BASE_URL/corporates/search" \
  -H "X-API-Key: $SALESBRAIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "filters": {
      "jobDescription": {"allContains": ["インサイドセールス", "新規開拓"]},
      "employeeCount": {"min": 50}
    },
    "limit": 10
  }'

検索語の作り方

最初は同じ意味の語をOR条件へまとめ、結果を確認してから企業属性や求人タイトルを追加します。

Claude Codeへ依頼する場合は、次のように対象、条件、出力項目を明示します。

セールスブレインAPIの /jobs/search を使い、
求人詳細本文に「Salesforce」または「HubSpot」を含む求人を検索してください。
最初は10件取得し、企業名、求人タイトル、descriptionSnippets、
jobPostingUrl、jobCreatedAtを表にしてください。

注意点

• descriptionSnippets は本文全体ではありません
• 本文を保持していない求人では、descriptionSnippets は空配列、詳細APIの description は null になる場合があります
• 検索語が一般的すぎる場合は、求人タイトル、職種、企業属性を追加します
• 求人本文から作った仮説は、掲載元URLや企業サイトでも確認します

次に読む

• 求人詳細取得・AI分類
• 求人検索API