/openwork/jobs/search

POST /api/openwork/jobs/search

Price: 10 credits

Search the OpenWork (openwork.jp) job board by keyword, work location, job category, industry, minimum salary, remote work and direct or agent application, or by the employer's employee score, overtime and paid-leave usage. Each job comes with its salary, locations, employment type, a description teaser and the employer with its employee score.

How to use it

Pass a job URL to openwork/jobs for the full posting, or the company id to openwork/companies for the employer's scores.

Parameters

• access-token string required

Request body

• timeout integer — Max scrapping execution timeout (in seconds) (default: 300; min: 20; max: 1500)
• count integer required — Max number of jobs to return (min: 1; max: 4000)
• keyword string nullable — Search words (examples: "データ", "Python"; minLength: 1)
• prefecture string nullable — Work location (one of: "北海道", "青森県", "岩手県", "宮城県", "秋田県", "山形県", "福島県", "茨城県", "栃木県", "群馬県", "埼玉県", "千葉県", "東京都", "神奈川県", "新潟県", "富山県", "石川県", "福井県", "山梨県", "長野県", "岐阜県", "静岡県", "愛知県", "三重県", "滋賀県", "京都府", "大阪府", "兵庫県", "奈良県", "和歌山県", "鳥取県", "島根県", "岡山県", "広島県", "山口県", "徳島県", "香川県", "愛媛県", "高知県", "福岡県", "佐賀県", "長崎県", "熊本県", "大分県", "宮崎県", "鹿児島県", "沖縄県", "海外")
• job_category_group string nullable — Job category group (one of: "営業", "管理・事務", "経営・事業企画", "マーケティング", "ITエンジニア", "機械・電気・電子・半導体(技術職)", "化学・繊維・食品(技術職)", "建築・土木・設備(技術職)", "メディカル(専門職)", "金融(専門職)", "不動産(専門職)", "コンサルタント・専門職", "クリエイティブ", "サービス・小売・運輸・その他")
• job_category string nullable — Job category (one of: "法人営業", "個人営業", "カウンターセールス・内勤営業", "代理店営業", "海外営業", "カスタマーサクセス", "営業企画・営業管理職", "MR・医療関連営業", "その他(営業)", "総務", "人事・労務", "法務", "内部監査", "特許・知的財産", "経理・会計・財務", "IR", "広報", "資材購買・調達", "物流", "国際業務・貿易事務", "秘書", "一般事務・営業事務", "医療事務", "受付", "経営者・CEO・COO", "経営企画・戦略", "事業企画・統括", "新規事業企画・事業開発", "CIO・CTO", "CFO・コントローラー", "プロダクトマーケティング・商品企画", "PR・広告宣伝・販促", "マーケティングリサーチ", "Webマーケティング", "バイヤー・マーチャンダイザー", "プロジェクトマネージャー", "ITコンサルタント・システムコンサルタント", "システム開発(WEB・オープン系)", "システム開発(汎用系)", "システム開発(制御・組込み系)", "モバイルアプリエンジニア", "サーバー設計・構築", "ネットワーク設計・構築", "セキュリティ設計・構築", "通信インフラ設計・構築", "プリセールス・セールスエンジニア", "品質管理・テスティング・QA", "テクニカルサポート・運用・保守", "社内SE", "データアナリスト・データサイエンティスト", "研究開発・企画", "製品開発・設計", "回路・電機・電機制御設計", "光学設計", "半導体・記録媒体・液晶プロセスエンジニア", "パターン・レイアウト設計", "評価・解析・検証", "生産技術・製造技術・エンジニアリング(機械・電気・電子・半導体(技術職))", "生産管理・品質管理・品質保証(機械・電気・電子・半導体(技術職))", "セールス・サポートエンジニア(機械・電気・電子・半導体(技術職))", "研究・開発", "生産技術・製造技術・エンジニアリング(化学・繊維・食品(技術職))", "生産管理・品質管理・品質保証(化学・繊維・食品(技術職))", "セールス・サポートエンジニア(化学・繊維・食品(技術職))", "設計・測量・積算(建築)", "施工管理(建築)", "保守・メンテナンス(建築)", "設計・測量・積算(土木)", "施工管理(土木)", "保守・メンテナンス(土木)", "設計・測量・積算(設備)", "施工管理(設備)", "保守・メンテナンス(設備)", "研究・開発(医薬品)", "臨床開発・学術・薬事(医療機器)", "臨床開発・治験(医薬品)", "製剤・薬事・学術", "生産管理・品質管理・品質保証(医薬品)", "セールス・サポートエンジニア(医療機器)", "医師", "薬剤師", "看護師", "その他メディカル系", "プライベートバンカー", "ファンドマネージャー・ディーラー・トレーダー", "投資研究・アナリスト・エコノミスト・ストラテジスト", "M&A・投資銀行部門", "アクチュアリー・クオンツ・金融工学", "リスク管理・与信管理・債権管理", "コンプライアンス・内部監査", "金融事務・バックオフィス", "アセットマネジメント・プロパティマネジメント", "鑑定・デューデリジェンス", "開発(用地仕入・企画)", "マンション管理・ビル管理", "経営・戦略・業務コンサルタント", "財務・会計コンサルタント", "組織・人事コンサルタント", "物流・SCMコンサルタント", "生産管理・品質管理コンサルタント", "弁護士・弁理士", "会計士・税理士", "司法書士・行政書士・社会保険労務士", "その他(専門職系)", "ディレクター(WEB)", "ディレクター(ゲーム)", "ディレクター(その他)", "デザイナー(WEB)", "デザイナー(アパレル・ファッション)", "Webコーディング", "プロダクト・工業デザイナー", "グラフィック・CGデザイナー", "DTPオペレーター", "映像クリエーター", "サウンドクリエーター", "編集・ライター", "芸能関連", "その他(クリエイティブ系)", "店長・店舗開発・スーパーバイザー", "販売", "カスタマーサポート・コールセンター運営・管理", "教師・講師・インストラクター", "警察官・消防士・自衛官", "行政事務・サービス職", "介護・福祉", "ウェディングプランナー", "ホテル・レジャー施設運営", "コーディネーター・仲介(人材・ブライダルなど)", "翻訳・通訳", "パイロット", "キャビンアテンダント", "運転手・セールスドライバー", "調理師・パティシエ・キッチンスタッフ", "飲食ホールスタッフ", "エステティシャン・ネイリスト・美容師", "整体士・マッサージ", "警備員", "学芸員・司書", "水産・農林・酪農・農園", "その他")
• industry_group string nullable — Company industry group (one of: "金融", "コンサルティング・専門事務所", "IT・通信・インターネット", "メーカー・商社", "メディカル", "マスコミ・広告関連", "サービス、小売、外食", "生活インフラ、運輸、不動産、建設", "行政機関、社団法人、非営利団体", "その他")
• industry string nullable — Company industry (one of: "銀行(都市・信託・政府系)、信金", "証券会社、投資ファンド、投資関連", "生命保険、損害保険", "投信投資顧問", "クレジット、信販、リース", "商品取引", "消費者金融、事業者金融", "その他金融関連", "コンサルティング、シンクタンク", "監査法人、税理士法人、法律事務所", "SIer、ソフト開発、システム運用", "インターネット", "通信、ISP、データセンター", "制御システム、組込みソフトウェア", "その他ＩＴ・通信関連", "総合商社", "総合電機、家電、AV機器", "自動車、自動車部品、輸送機器", "コンピュータ、通信機器、OA機器関連", "半導体、電子、精密機器", "重電、産業用電気機器、プラント関連", "鉄鋼、非鉄金属", "機械関連", "化学、石油、ガラス、セラミック", "食品、飲料", "日用品、化粧品", "ファッション、アパレル、繊維", "インテリア、雑貨、文具、スポーツ", "印刷、紙・パルプ、書籍、パネル", "住宅設備、建材、エクステリア", "ゲーム関連、玩具", "その他メーカー・商社", "医薬品、医療機器", "治験、臨床試験、医薬営業受託", "調剤薬局", "バイオ関連", "病院、医療機関", "その他医療・医薬サービス", "放送、出版、新聞、映像、音響", "広告代理店、PR、SP、デザイン", "その他マスコミ関連", "小売(百貨店・専門・CVS・量販店)", "通信販売", "物品レンタル", "フードサービス、飲食", "旅行、ホテル、旅館、レジャー", "冠婚葬祭", "人材サービス", "コールセンター、業務請負", "情報サービス、リサーチ", "教育、研修サービス", "警備、メンテナンス", "介護、福祉関連サービス", "美容、エステ、リラクゼーション", "環境サービス", "受託製造(設計・開発・加工)", "その他小売、外食、レジャー、サービス", "電力、ガス、エネルギー", "航空、鉄道、運輸、倉庫", "不動産関連、住宅", "建築、土木、設備工事", "官公庁", "独立行政、社団、財団、学校法人", "非政府組織(NGO)、非営利団体(NPO)", "農業、林業、水産、畜産", "鉱業")
• salary_min integer nullable — Minimum annual salary in JPY (one of: 3000000, 3500000, 4000000, 4500000, 5000000, 6000000, 7000000, 8000000, 10000000, 12500000, 15000000, 20000000)
• company_score_min number nullable — Minimum overall employee score of the company (examples: 3.5)
• overtime_hours_max integer nullable — Maximum monthly overtime hours at the company (one of: 20, 40, 60, 80)
• paid_leave_rate_min integer nullable — Minimum paid-leave usage percent at the company (one of: 20, 40, 60, 80)
• remote_work string nullable — Remote work (one of: "remote_main", "remote_allowed")
• application string nullable — Direct application or via an agent (one of: "direct", "agent")
• sort string — Result order (default: "recommended"; one of: "recommended", "newest")

Response

• @type string (default: "OpenworkJobCard")
• id string required
• url string required
• job_number string nullable
• position string nullable
• job_category string nullable
• description string nullable
• salary_text string nullable
• salary_min number nullable
• salary_max number nullable
• salary_currency string nullable
• salary_period string nullable
• is_salary_hidden boolean nullable
• locations array (default: [])
• location_text string nullable
• work_area_text string nullable
• remote_work string nullable
• is_regular_employee boolean nullable
• is_contract_employee boolean nullable
• is_new_graduate boolean nullable
• is_direct_application boolean nullable
• is_agent boolean nullable
• application_count integer nullable
• image string nullable
• published_at integer nullable
• company object required
  • @type string (default: "OpenworkJobCompany")
  • id string required
  • url string required
  • company_number string nullable
  • name string nullable
  • name_detail string nullable
  • image string nullable
  • score number nullable
  • industry_name string nullable
  • description string nullable

Errors

• 422 — An unknown filter value, or a category combined with its group Check the fields against this schema. A URN with the wrong prefix is the most common cause.
• 408 — The request ran past its time limit Raise `timeout` in the request body, up to the maximum this endpoint documents. Lowering `count` or turning off the `with_*` flags also helps, because less work finishes sooner.
• 412 — The entity was not found, or a precondition failed Retrying will not help: either the entity does not exist, or the input points at a different one.
• 429 — Too many requests: a rate limit or a usage window is exhausted When the response carries an X-Retry-After header, wait that many seconds and retry: the same number is in the body as `detail.retry_after`, and the limit clears once that window passes. The message in the body names the limit that was hit.
• 500 — Something broke on our side Retrying will not help. If it keeps happening, send us the X-Request-ID from the response headers.
• 529 — Rate limit reached, or the endpoint is overloaded Wait at least 30 seconds, then retry.

Response headers

• X-Error — Error message text (present only on error)
• X-Request-ID — Unique request identifier
• X-Execution-Time — Execution time in seconds
• X-Result-Count — How many records the body carries. 0 means an empty result, which is a normal answer and not by itself an error. A non-zero count can come back together with X-Error when the failure happened partway through — read this header and X-Error independently.
• X-Total-Available-Results — How many records exist for this query, when the endpoint can say. On a `dry_run` request this is the answer and the body is empty. It saturates: the endpoint's documented maximum means 'at least that many', any smaller number is exact.
• X-Warning — Present when the request body carried keys this endpoint does not document. They were ignored, so any filter you meant to apply through them did not apply. Check the spelling against this schema and retry.
• X-Retry-After — Seconds to wait before retrying. Present only on 429.