求人詳細本文検索

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

検索対象

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

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

検索条件

POST /jobs/searchでは該当求人を、POST /companies/searchでは該当求人を持つ企業を返します。両方とも検索条件を filter に指定し、結果を { total, items } で受け取ります。

求人を検索する

printf 'header = "X-API-Key: %s"\n' "$SALESBRAIN_API_KEY" |
  curl -sS --config - "$SALESBRAIN_API_BASE_URL/jobs/search" \
  -H "Content-Type: application/json" \
  -d '{
    "filter": {
      "job": {
        "description": {
          "anyContains": ["Salesforce", "HubSpot"],
          "noneContains": ["募集終了"]
        }
      }
    },
    "limit": 10,
    "offset": 0,
    "includeTotalResults": true
  }'

企業を検索する

printf 'header = "X-API-Key: %s"\n' "$SALESBRAIN_API_KEY" |
  curl -sS --config - "$SALESBRAIN_API_BASE_URL/companies/search" \
  -H "Content-Type: application/json" \
  -d '{
    "filter": {
      "company": {"employeeCount": {"gte": 50}},
      "job": {
        "description": {"allContains": ["インサイドセールス", "新規開拓"]}
      }
    },
    "limit": 10
  }'

検索語の作り方

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

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

セールスブレインAPIの /jobs/search を使い、
求人詳細本文に「Salesforce」または「HubSpot」を含む求人を検索してください。
条件は filter.job.description.anyContains に指定してください。
最初は limit 5 で取得し、items の各求人の company.name、title、
descriptionSnippets、jobPostingUrl、jobCreatedAt を表にしてください。

注意点

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

次に読む

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