單一個詞可以不加雙引號, https://cbdata.dila.edu.tw/dev/search/extended?q=法鼓 與 https://cbdata.dila.edu.tw/dev/search/extended?q="法鼓" 的結果相同。
但 AND、OR、NOT、NEAR、Exclude 語法的每個詞都必須用雙引號括起來, 否則整個查詢字串會被當成一個詞。
查詢字串 (q) 長度上限為 40 字,超過會回傳錯誤。
以下範例均要做 URL encode, 例如:
"波羅蜜" | "波羅密"
要編碼為
%22波羅蜜%22%20%7C%20%22波羅密%22
多個字詞都必須出現。將每個詞用雙引號括起來,再以空格隔開多個字詞。
例:https://cbdata.dila.edu.tw/dev/search/extended?q="法鼓" "聖嚴"
"波羅蜜" | "波羅密"
例:https://cbdata.dila.edu.tw/dev/search/extended?q="波羅蜜" | "波羅密"
例:https://cbdata.dila.edu.tw/dev/search/extended?q="迦葉" !"迦葉佛"
例: https://cbdata.dila.edu.tw/dev/search/all_in_one?q="法鼓" NEAR/7 "迦葉"
NEAR/ 後面的數字 表示兩個關鍵詞中間的距離
https://cbdata.dila.edu.tw/dev/search/extended?q="老子" NEAR/7 "道" NEAR/3 "經"
NEAR 查詢只回傳 num_found (符合的卷數),不含 total_term_hits。 需要出現次數請改用 all_in_one ,該 endpoint 會逐卷計算。
搜尋「直心」,排除「正直心」: https://cbdata.dila.edu.tw/dev/search/extended?q="直心" -"正直心"
搜尋「舍利」,排除「舍利弗」: https://cbdata.dila.edu.tw/dev/search/extended?q="舍利" -"舍利弗"
被排除的字串必須包含原本要搜尋的詞,否則回傳錯誤。
括號分組、
~n
(proximity)、
&
不在支援範圍,會在回傳的 error 欄位說明原因 (HTTP status 仍是 200)。
| 參數名稱 | 說明 | |
| rows | 選項 | 每頁回傳筆數,預設為 20。 |
| start | 選項 | 分頁回傳起始位置,預設為 0。 |