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為指定回傳格式。各參數與參數值說明如下：
- cat：職務類別，2007001006為「Internet程式設計師」
- role：職缺類別，1,4為複合條件的表示方式，表「全職+全職身障」
- fmt：輸出格式，2表指定輸出結果為「結果數」
上述URL執行結果如下：
當然可用的參數還有很多，以下將一一介紹。在這之前，先介紹3個圖示。
：必填，表示此為必要的參數。
：預設值，不查詢的參數就不用帶出來，但帶出此參數卻不指定值時，系統就會預設給這個值。
：可複選，表示此參數可接受1個以上的值，數字表示最大可接受的數量，值與值之間以逗號分隔。
參數與使用範例
指定API的回傳格式與回傳欄位值。目前支援格式如下：
使用範例
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格式，並注意瀏覽器的字串長度限制
- JavaScript: 使用window.encodeURIComponent()
- Java: 使用 java.util.URLEncoder().encode(s)
- PHP: 使用 urlencode(s)
- ASP.net: 使用 HttpServerUtility.UrlEncode(s)
- ColdFusion: 使用 urlEncodedFormat(s)
使用範例
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
- 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
使用上列查詢條件，請點擊選單，選出需要查詢的條件，系統會自動帶出對應值。
使用範例
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的參數值(即職務代碼, 下圖紅框處)
使用範例
http://www.104.com.tw/i/apis/jobsearch.cfm?
j=3f4d466e37494159485b3e2451673a1e15d73462a596f4224242424683d414f28654j02,
673f4870394b435b36373f6845433c675553f4870494b4326262626243d33432a735j55&fmt=4
求職客服信箱