画面の検索条件をAPIで使う

企業検索・求人検索で設定した条件は、検索画面からREST API用のcURLへ変換できます。画面で検索結果を確認してから、自社システムやスクリプトへ移すときに利用します。

cURLを生成する

1. 企業検索または求人検索で条件を設定します
2. 画面上部の「API」を押します
3. エンドポイントとリクエスト本文を確認します
4. 「コピー」を押します
5. <your-api-key> を自分のAPIキーに置き換えて実行します

企業検索では POST /corporates/search、求人検索では POST /jobs/search が生成されます。送信先は https://api.salesbrain.jp/rest/v1 です。

cURLに反映されるもの

• 現在設定している企業・求人フィルター
• 1回の取得件数 limit
• 取得開始位置 offset
• Content-Type: application/json
• X-API-Key: <your-api-key>

通常の検索条件は filters、条件グループは filterGroups へ変換されます。limit、offset、includeTotalResults はリクエストのトップレベルに入ります。

画面上の並び順と「列の表示」はcURLに反映されません。必要な場合は、APIの仕様に沿ってリクエストまたは取得後の処理へ追加してください。

APIキーを準備する

APIキーの作成手順はAPIキーと認証を参照してください。APIの項目定義は、WebアプリのAPIドキュメント ↗で確認できます。

期待した結果にならない場合

• 同じ条件でWebアプリの検索結果を確認します
• マスター選択項目は、APIへ送られるIDを確認します
• limit と offset が想定したページになっているか確認します
• APIキーが有効か確認します
• レスポンスのHTTPステータスとエラー本文を確認します
• 旧形式の検索条件を使っている場合は、高度な検索機能リリースのお知らせの変更例を確認して更新します

次に読む

• APIキーと認証
• 企業検索API
• 求人検索API
• 高度な検索機能リリースのお知らせ