經濟部智慧財產局-便民服務-電子報-特蒐情報站-專利資料介接服務(API)操作說明

專利資料介接服務(API)操作說明

全球專利檢索系統API服務，為便於產業界應用，貼心提供「網址工具」，使用者可利用API網址工具，依據指定的專利檢索條件產生API網址，亦可直接修改API網址內的各項參數來調整專利檢索條件，API網址工具可選擇檢索資料庫、專利類型、檢索式、輸出欄位及輸出格式，產生指定檢索條件的API URL(資料擷取用網址)，API服務採用REST Web API，使用者可以透過該API URL以HTTPS GET方式向API URL取得指定檢索條件之專利資料，API呼叫回傳則提供兩種常見的標準化內容格式Xml及Json。

使用者在利用全球專利檢索系統之API服務前，需透過API驗證碼線上申請功能向本局申請API驗證碼(全球專利檢索系統→API→使用說明→驗證碼申請→API驗證碼線上申請→取得驗證碼)，API服務參數包含驗證碼、檢索設定、檢索條件、輸出設定，使用者可依各項參數調整API網址，取得專利案件資料，以下說明API服務各項參數及應用方式。

一、專利資料範圍
目前API服務提供之之專利資料範圍包括全球專利檢索系統所涵蓋之專利，資料內容及對應代碼如下表:

國家		資料內容	國家		資料內容
中華民國	TWA	公開	韓國	KPA	公開(無全文)
	TWB	公告		KPB	公告(無全文)
	TWD	設計		KPD	設計
美國	USA	公開	中國大陸	CNA	公開
	USB	公告		CNB	公告
	USD	設計		CND	外觀設計
日本	JPA	公開(無全文)	WIPO	WO	公開
	JPB	公告	東南亞	SEAA	公開(無全文)
	JPD	意匠		SEAB	公告(無全文)
歐洲	EPA	公開	其他國家	OTA	公開(無全文)
	EPB	公告	其他國家	OTB	公告(無全文)
	EUIPO	設計

API服務參數包含驗證碼(必備)、檢索設定、檢索條件(必備)、輸出設定，使用者得依各項參數調整API網址，取得專利案件資料。二、API網址參數

三、API服務參數表

下表為API服務提供的項目與參數名稱，可將各參數以「&」組合成URL，取得專利案件資料。(相關參數代碼請參考：全球專利檢索系統→API→使用說明→相關文件下載→欄位代碼)。

API URL：使用範例:
https://gpss1.tipo.gov.tw/gpsskmc/gpss_api?userCode=驗證碼&參數名稱=值

種類	服務項目	參數名稱	範例
必備	驗證碼	userCode	userCode=1234abcd5678efgh
檢索設定	資料庫	patDB	patDB=TWA,TWB,TWD,USA,USB, USD,JPA,JPB,JPD,EPA,EPB, EUIPO,KPA,KPB,KPD,CNA, CNB,CND,WO,SEAA, SEAB,OTA,OTB (若未輸入，預設值為全部)
	案件類型 (公開案、公告案)	patAG	patAG=A,B (若未輸入，預設值為全部)
	專利類型 (發明、新型、設計)	patTY	patTY=I,M,D (若未輸入，預設值為全部)
檢索條件	公開/公告號公開/公告日	PN ID	PN=TW201644272A ID=2020:2021
	申請號申請日	AN AD	AN=TW105131793 AD=20191107:
	申請人名第一申請人名申請人國別第一申請人國別	AX AF AY AZ	AX=林大成AND陳曉明 AF=陳曉明 AY=US OR TW AZ=US OR 美國
	發明人名發明人國別	IV IY	IV=林意美 IY=TW
	代理人名	LX	LX=陳建文
	審查委員	EX	EX=王筱雯
	優先權優先權日	PR DR	PR= US201514879928 DR=202001:202012
	IPC 第一 IPC	IC FC	IC= G01S 5/02 AND G01S 1/00 FC=H04L
	CPC 第一 CPC	CS TS	CS=H02J AND B60R TS=F16H 63/3466
	LOC	IQ	IQ= 05-05 OR 05-06
	FI F-TERM D-TERM USPC	FI FT IR UC	FI=H02K1/22A OR H02J13 FT=5G064 IR=C3 UC=D34
	專利名稱摘要專利範圍引用專利	TI AB CL CI	TI=無線裝置 OR 通訊裝置 AB=降低功耗 AND 無線 CL=無線電and藍牙and晶片 CI=TW104702
輸出設定	輸出欄位	expFld	expFld=PN,AN,ID,AD,TI,PA,IN,LX, EX,PR,AB,IC,IQ,CS,UC,FI, FT,IR,CI,CL (若未輸入，預設值為 PN,ID,AN,AD,TI)
	輸出格式	expFmt	expFmt=xml (預設值) expFmt=json
	輸出筆數	expQty	expQty=30 (預設值)
	跳躍筆數	expSkip	expSkip=100

四、API網址

使用者可利用API網址工具，依據指定的專利檢索條件產生API網址，亦可直接修改API網址內的各項參數來調整專利檢索條件。

●API網址規則
1. 各項參數以「&」連結，串接成完整的API網址。
2. 檢索條件裡，欄位內的關鍵字以and、or、not組合；跨欄位的條件，預設為AND組合，若要以OR組合，則在參數前加上「+」；若以NOT 組合，則在參數前加上「-」。

●API檢索範例

資料庫:	本國公開、本國公告、美國公開、美國公告、歐洲公開、歐洲公告
案件類型	公開案、公告案
專利類型	發明專利、新型專利
檢索條件	專利名稱或摘要有「網架結構」或「Filter frame」發明人國別為「US」，排除 IPC 為「F24F」公開/公告日在2010010之後
輸出欄位	公開/公告號、公開/公告日、專利名稱、發明人、優先權、摘要、專利範圍
輸出格式	Xml
輸出筆數	10筆
依上述參數組成之API URL如下:
https://gpss1.tipo.gov.tw/gpsskmc/gpss_api?userCode=驗證碼 &patDB=TWA,TWB,USA,USB,EPA,EPB &patAG=A,B &patTY =I,M &TI=網架結構or Filter frame&+AB=網架結構or Filter frame &IY=US&-IC=F24F&ID=20100101: &expFld=PN,ID,TI, IN,PR,AB,CL &expFmt=xml&expQty=10

範例參數說明

項目	網址參數		參數說明
驗證碼	userCode	=驗證碼	審核通過的API驗證碼，為必填欄位。
資料庫	patDB	=TWA,TWB,USA,USB, EPA,EPB	TWA：本國公開 TWB：本國公告 USA：美國公開 USB：美國公告 EPA：歐洲公開 EPB：歐洲公告
案件類型	patAG	=A,B	A：公開案 B：公告案
專利類型	patTY	=I,M	I：發明專利 M：新型專利
檢索條件	TI	=網架結構 or Filter frame	專利名稱包含「網架結構」或「Filter frame」
	+AB	=網架結構 or Filter frame	OR摘要包含「網架結構」或「Filter frame」
	IY	=US	AND 發明人國別包含「US」
	-IC	=F24F	NOT IPC 為「F24F」
	ID	=20100101:	AND 公開/公告日在「20100101」之後
輸出欄位	expFld	=PN,ID,TI,IN,PR,AB,CL	PN：公開/公告號 ID：公開/公告日 TI：專利名稱 IN：發明人 PR：優先權 AB：摘要 CL：專利範圍
輸出格式	expFmt	=xml	以 Xml 格式輸出
輸出筆數	expQty	=10	輸出 10 筆專利資料

五、回傳結果

若有符合API網址之專利資料，則依設定輸出，輸出格式可參見(全球專利檢索系統→API→使用說明→相關文件下載→輸出格式說明)，若網址錯誤或無符合之資料則會回傳相關訊息，訊息說明為下：

項目	API網址情形	回傳訊息
API驗證碼	無效API驗證碼	userCode not exist
	API驗證碼過期	userCode expired
	以無效驗證碼連結次數超過限制，IP被封鎖	IP blocked
網址條件	查無結果	No record found
	跳躍筆數超過總筆數	expSkip too much
	未包含檢索條件	No search command
	包含切截或字距運算	Cannot use truncated and kerning in search conditions
	包含未提供查詢的欄位	unknow field:[欄位]
流量限制	輸出筆數超過該時段剩餘數量時，僅輸出剩餘流量的筆數	Over download quantity
流量限制	輸出筆數已超出時段限制數量	Over download quantity

專利資料介接服務(API)操作說明

相關連結

訂閱電子報