很抱歉,您的瀏覽器不支援Javascript
您必需先開啟JavaScript支援或安裝支援JavaScript的瀏覽器方能正常使用本服務。
註冊|登入 104人力銀行▼新體驗▼部落格工作貼紙

Job Search API

API說明文件

跟 API 說聲 Hello World

使用104 Job Search API服務,最快的方式就是把下面的URL複製到網址列上執行:

http://www.104.com.tw/i/apis/jobsearch.cfm?cat=2007001006&role=1,4&fmt=2

以上面URL為例,分為參數與參數值,參數有3,cat為職務類別,role為身份類別(全職或兼職或高階),fmt為指定回傳格式。各參數與參數值說明如下:

上述URL執行結果如下:

當然可用的參數還有很多,以下將一一介紹。在這之前,先介紹3個圖示。


參數與使用範例

fmt 回傳格式 預設值0cols輸出欄位 可複選n

指定API的回傳格式與回傳欄位值。目前支援格式如下:

  • 1=RSS
  • 2=查詢結果筆數
  • 3=查詢結筆果數,[職務代碼LIST]
  • 4=xml 支援cols參數,請參考輸出欄位列表
  • 6=json(multiple query筆數)
  • 7=json(multiple query次查詢筆數)
  • 8=JSON 支援cols參數,請參考輸出欄位列表
  • 9=查詢條件說明

使用範例

http://www.104.com.tw/i/apis/jobsearch.cfm?cat=2001001001&area=6001001001&fmt=4&
cols=J,JOB,NAME
  • page頁數(指定回傳頁數)預設值1
  • pgsz每頁筆數, 指定每次輸出筆數預設值25

各種查詢條件的組合,最多回傳2000筆

使用範例

http://www.104.com.tw/i/apis/jobsearch.cfm?cat=2001001001&page=1&pgsz=10&fmt=4
&cols=J,JOB,NAME

order排序欄位預設值0

  • 0=相關性(不排序,同order=1)
  • 1=相關性(依照關鍵字查詢結果權重)
  • 2=職務更新日期
  • 3=經歷
  • 4=學歷
  • 5=地區
  • 6=月薪(時薪與年薪會轉成月薪排序,時薪*160=月薪, 年薪/12=月薪)
  • 7=兩週內主應人數(與MY104職缺應徵分析使用相同資料)

使用範例

http://www.104.com.tw/i/apis/jobsearch.cfm?cat=2001001001&area=6001001001&order=2
&fmt=4&cols=J,JOB,NAME

asc排序升降冪 預設值0

0=降冪 1=升冪,與排序欄位支援性如下表

欄位 降冪(0) 升冪(1)
相關性    
最後更新日期 v(由近到遠排序)  
經歷 v(由經歷大到小排序) v(由經歷小到大排序)
學歷 v(由學歷高到低排序) v(由學歷低到高排序)
地區   v(依照地區編排方式排列)
薪資* v(月薪由少到多排序) v(月薪由多到少排序)
兩週內主應人數 v(由小到大排序) v(由大到小排序)

* 以薪資排序,無論升冪與降冪,未填薪資者(面議、依公司規定、論件計酬)一律排在有填薪資者後方

使用範例

http://www.104.com.tw/i/apis/jobsearch.cfm?cat=2001001001&area=6001001001&order=3
&asc=1&fmt=4&cols=J,JOB,NAME,PERIOD

kws關鍵字 預設值空值 可複選n

查詢的關鍵字,使用HTTP呼叫時,必須將字串編碼(URL Encode)為UTF-8格式,並注意瀏覽器的字串長度限制

使用範例

http://www.104.com.tw/i/apis/jobsearch.cfm?
kws=Internet%E7%A8%8B%E5%BC%8F%E8%A8%AD%E8%A8%88%E5%B8%AB
&area=6001001000&order=2&fmt=4&cols=J,JOB,NAME

kwop關鍵字查詢範圍 預設值1

指定關鍵字查詢的範圍

  • 1=職務名稱
  • 2=職務名稱,職務說明,公司名,公司產品,公司簡介,福利制度,產業別描述,擅長工具描述,工作技能描述
  • 3=職務名稱,職務說明,公司名,公司產品,公司簡介,福利制度,產業別描述,其他說明,公司連結,職務別描述,職務產業別描述,科系別描述,證照描述,擅長工具描述,工作技能描述
  • 4=職務名稱,職務說明,公司簡介,產業別描述,職務其他描述,職務類別描述,職務產業別描述

使用範例

http://www.104.com.tw/i/apis/jobsearch.cfm?
kws=Internet%E7%A8%8B%E5%BC%8F%E8%A8%AD%E8%A8%88%E5%B8%AB
&kwop=3&fmt=4&cols=J,JOB,NAME

fz關鍵字查詢方式 預設值1

  • 1=104人力銀行關鍵字查詢方式
  • 3=104i關鍵字查詢方式

使用範例

http://www.104.com.tw/i/apis/jobsearch.cfm?
kws=Internet%E7%A8%8B%E5%BC%8F%E8%A8%AD%E8%A8%88%E5%B8%AB
&fz=1&fmt=4&cols=J,JOB,NAME

zn推薦專區 可複選5 ,提供104首頁「推薦專區」項目,支援項目如下:

  • 1=竹科專區
  • 2=南科專區
  • 3=千大專區
  • 4=資訊外商
  • 5=一般外商
  • 8=新鮮人
  • 9=原住民
  • 10=國防役專區
  • 11=外籍
  • 12=日間部打工
  • 13=夜間部打工
  • 14=派遣
  • 15=獵才
  • 16=上市上櫃專區
  • 17=夜貓專區
  • 18=科技人
  • 19=內湖科學園區
  • 20=南港科學園區
  • 21=中科科學園區

使用範例

http://www.104.com.tw/i/apis/jobsearch.cfm?zn=1&fmt=4&cols=J,JOB,NAME

role身份類別 必填 預設值0

  • 0=不拘
  • 1=全職
  • 2=兼職
  • 3=高階

使用範例

http://www.104.com.tw/i/apis/jobsearch.cfm?area=6001001001&role=1,4&fmt=4
&cols=J,JOB,NAME

incs是否搜尋外包案件 預設值0

  • 0=不拘(要搜尋外包案件)
  • 1=只搜尋外包案件
  • 2=排除外包案件

使用範例

http://www.104.com.tw/i/apis/jobsearch.cfm?kws=java&incs=1&fmt=4&cols=J,JOB,NAME

intmp:是否搜尋派遣職缺 預設值0

  • 0=不拘(要搜尋派遣工作)
  • 1=只搜尋派遣工作
  • 2=排除派遣工作

使用範例

http://www.104.com.tw/i/apis/jobsearch.cfm?area=6001001001&intmp=1&fmt=4
&cols=J,JOB,NAME

dis_type身障類別 預設值0

  • 0=不拘
  • 1=僅身障
  • 2=排除身障

使用範例

http://www.104.com.tw/i/apis/jobsearch.cfm?area=6001001001&role=1&dis_type=0
&fmt=4&cols=J,JOB,NAME

role_status希望求職者狀態 可複選9

  • 1=上班族
  • 2=應屆畢
  • 4=日間部
  • 8=夜間部
  • 16=尋找國防役
  • 32=外籍人士
  • 64=原住民
  • 128=接受人力派遺
  • 256=二度就業

使用範例

http://www.104.com.tw/i/apis/jobsearch.cfm?area=6001001001&role=1&dis_type=0
&role_status=128,256&fmt=4&cols=JOB,NAME,ROLE_STATUS

mgmt管理責任 預設值-1

  • 0=無
  • 1=4人以下
  • 2=5~8人
  • 3=9~12人
  • 4=13人以上
  • 5=有,但人數未定

使用範例

http://www.104.com.tw/i/apis/jobsearch.cfm?cat=2001001001&mgmt=2&fmt=4
&cols=JOB,NAME,S2

sltp薪資查詢條件 可複選4

  • D=面議
  • R=依公司規定
  • C=論件計酬
  • S=月薪 (需搭配slmax與slmin)

slmin最低薪資(月薪) (單位/元)。若未指定身份類別(全/兼/高),則轉換薪資條件至月薪查詢

slmax最高薪資(月薪) (單位/元)。若未指定身份類別(全/兼/高),則轉換薪資條件至月薪查詢

例:

面議,依公司規定, 論件計酬之職缺:sltp=D,R,C

面議,依公司規定, 且月薪包含2萬5千元至3萬元之間的職缺:sltp=D,R,S&slmin=25000&slmax=30000

使用範例

http://www.104.com.tw/i/apis/jobsearch.cfm?cat=2001001000&sltp=D,R&slmin=25000
&slmax=30000&fmt=4

dis_role身障類型

  • 0=不拘
  • 1=視覺障礙
  • 2=聽覺或平衡機能障礙
  • 3=自閉症
  • 4=慢性精神病
  • 5=肢體障礙(上肢)
  • 6=肢體障礙(下肢)
  • 7=肢體障礙(軀幹)
  • 8=聲音或語言機能障礙
  • 9=顏面損傷
  • 10=其他障礙

dis_level身障等級

  • 0=不拘
  • 1=輕度
  • 2=中度
  • 4=重度
  • 8=極重度

使用範例

http://www.104.com.tw/i/apis/jobsearch.cfm?cat=2001001000&role=1&dis_type=1
&dis_role=1&dis_level=1&fmt=2

cat職務類別 可複選5  查詢代碼

area地區別, 可傳入字串查詢 可複選5  查詢代碼

ind產業類別 可複選5  查詢代碼

major科系類別 可複選5  查詢代碼

comp電腦專長, 可傳入字串查詢 可複選5  查詢代碼

jskill工作技能, 可傳入字串查詢 可複選5  查詢代碼

cert認證, 可傳入字串查詢 可複選5  查詢代碼

使用上列查詢條件,請點擊選單,選出需要查詢的條件,系統會自動帶出對應值。

使用範例

http://www.104.com.tw/i/apis/jobsearch.cfm?cat=2001001000&major=3001001000&fmt=8
&cols=JOBNO,NAME,JOB

edu2學制 可複選6

  • 1=高中以下
  • 2=高中
  • 3=專科
  • 4=大學
  • 5=碩士
  • 6=博士

使用範例

http://www.104.com.tw/i/apis/jobsearch.cfm?cat=2001001000&edu2=3,4&fmt=8&
cols=JOBNO,EDU2,NAME,JOB

exp工作經驗

  • -1=無工作經驗
  • 0=未滿一年
  • 1=一年以上
  • 2=二年以上
  • 3=三年以上
  • 4=四年以上
  • 5=五年以上
  • 6=六年以上
  • 7=七年以上
  • 8=八年以上
  • 9=九年以上
  • 10=十年以上

exp_all工作經驗查詢設定

  • 0=剛好
  • 1=含以上
  • 2=含以下

使用範例

http://www.104.com.tw/i/apis/jobsearch.cfm?cat=2001001000&exp=1&exp_all=1&fmt=8
&cols=JOBNO,JOB

lang語言條件

  • 1=英文
  • 2=日文
  • 3=法文
  • 4=德文
  • 5=西班牙文
  • 9=越文
  • 10=泰文
  • 11=馬來文
  • 12=印尼文
  • 13=韓文
  • 14=俄文
  • 15=義大利文
  • 16=葡萄牙文
  • 17=阿拉伯文
  • 18=中文
  • 19=菲律賓文
  • 49=其他外文

cap語言程度

  • 1=不會
  • 2=精通
  • 4=略懂
  • 8=中等

lang_all語文能力篩選範圍 預設值0

  • 0=剛好
  • 1=含以上
  • 2=含以下

使用範例

http://www.104.com.tw/i/apis/jobsearch.cfm?cat=2001001000&lang=1&cap=2&lang_all=2
&fmt=2

startby可開始上班時間

  • 0=即時
  • 1=兩週內
  • 2=一個月內
  • 3=不限

使用範例

http://www.104.com.tw/i/apis/jobsearch.cfm?cat=2001001000&startby=1&fmt=2

wktm休假制度,依據不同身份類別,可查詢之條件分別如下: 可複選9

  • 全職:
    • 依公司規定
    • 週休二日
    • 隔週休
    • 排班制
    • 三班制
  • 兼職:
    • 白天
    • 晚上
    • 假日
    • 需排班
    • 依公司規定
  • 高階:依公司規定

使用範例

http://www.104.com.tw/i/apis/jobsearch.cfm?role=1,4
&wktm=%E4%B8%89%E7%8F%AD%E5%88%B6&fmt=2

wktp工作性質 可複選6 *僅支援身份類別為兼職之職缺

  • 1=長期工讀
  • 2=短期工讀
  • 4=假日工讀
  • 8=寒假工讀
  • 16=暑假工讀
  • 32=企業實習

使用範例

http://www.104.com.tw/i/apis/jobsearch.cfm?role=2,5&wktp=32&fmt=2

c查詢指定公司 可複選5

指定查詢之公司, 請帶入104人力銀行網站上看到的公司頁網址中,j的參數值(即公司代碼, 下圖紅框處)

紅框處為公司代碼
以上圖為例,623a436e5a46402140323c1d1d1d1d5f2443a363189j50 即為公司代碼

使用範例

http://www.104.com.tw/i/apis/jobsearch.cfm?
c=623a436e5a46402140323c1d1d1d1d5f2443a363189j50&fmt=2

j查詢指定職務 可複選5

指定查詢之職務, 請帶入104人力銀行網站上看到的職務頁網址中,j的參數值(即職務代碼, 下圖紅框處)

紅框處為職務代碼
以上圖為例,3a3c46705838415833343c65583039642604c4627463842232323231e3c2d2827563j97 即為職務代碼

使用範例

http://www.104.com.tw/i/apis/jobsearch.cfm?
j=3f4d466e37494159485b3e2451673a1e15d73462a596f4224242424683d414f28654j02,
673f4870394b435b36373f6845433c675553f4870494b4326262626243d33432a735j55&fmt=4

注意

104 Job Search API提供了許許多多的參數。在閱讀這些參數的用法之餘,有些事情我們必須提醒您注意:

  • 透過HTTP呼叫有網址列的長度限制(2k),如果您的網址長度會超過2K,請改用POST(沒錯,104 Job Search API也支援POST!)。
  • 查詢條件內含中文字的部份請務必編碼後再送出,以免被解釋為亂碼造成查詢結果有誤。
  • 不正確的參數值將會被修正為預設值,因此可能會影響到您的查詢結果,請再次確認您的查詢條件是否正確。
  • 職務可能因屆到期日或廠商徵才需求而有異動,故每次查詢的結果數量不保證一致。
  • 若您在使用中有發現任何問題,請隨時向我們回報,謝謝!