PicSee 提供 API 讓程式串接，讓網站、AI Agent、CDP 或 App 等程式可以透過 PicSee 自動縮網址，而不需要進入網站手動操作。

使用場景

企業串接案例

當您在肯德基 App 中點餐，點完餐後您會收到一封確認信（或簡訊），裡面縮網址點下去可以看到目前訂單的狀態。不知道您有沒有想過，難道肯德基是讓工讀生為每個訂單縮網址嗎？這樣也太血汗了吧！

當然不是，這就是透過 API 建立的短網址，當你完成訂餐後，肯德基的後台程式會呼叫 PicSee 的 API，把訂單的長網址縮短，再把短網址傳送給您。

順帶一提，台灣肯德基的 kfcclub.tw 短網址也是 PicSee 的品牌短網址。

個人串接使用

如果是個人使用者，不需要撰寫程式，開通 API 後還可享有以下功能：

• 在瀏覽器一鍵把當前網頁建立短網址：安裝瀏覽器擴充功能（支持 Chromium 瀏覽器），按下擴充功能即可將目前瀏覽的網頁轉換成短網址，並帶有 QR Code。
  
• 在 ChatGPT 裡建立短網址、查詢成效：甚至可以產出分析簡報、把 Excel 內所有網址縮短！
  
• 整合 AI 代理人工作流程：可讓 OpenClaw、Claude Cowork 等代理人建立短網址、查詢成效。
  
• 自己在 Excel 裡建立縮網址巨集：可以參考這篇教學。
  

使用 PicSee 的 API

功能概觀

詳細說明需參考API 文件，以功能最完整的 API Advanced 版，提供以下功能：

1. 建立短網址：API 建立的短網址會在連結紀錄頁的「批次紀錄」頁籤中
   
2. 編輯、刪除短網址
   
3. 短網址列表、短網址搜尋
   
4. 短網址成效、每日點擊、點擊來源、點擊裝置、點擊國家/地區
   
5. 批次建立短網址
   

備註：您也可以直接將 openapi.yaml 檔案貼給 AI，讓 AI 直接串接。

取得 API Token

免費註冊的使用者在完成簡訊驗證後，可透過以下方式取得 API Token，每個帳號每年有 800 筆免費的 API 用量，每年重設：

1. 點選右上角帳號頭像，前往「設定」。
   
2. 左邊切換到「API 設定」頁籤會看到目前方案。
   
3. 在「API Token」區塊中點擊「免費開通」即會看到目前 API 方案。
   
4. 滑鼠點擊 API Token 中的眼睛圖示即可取得專屬 API Token。
   

備註：若您的身份是群組成員的「一般成員」，請聯繫群組的「管理員」來取得 API Token。

用量通知及查看用量

您可以透過 API 查看目前用量，也可以在 PicSee 網站中查看，方法如下：

1. 點選右上角帳號頭像，前往「設定」。
   
2. 左邊切換到「API 設定」頁籤。
   
3. 在「用量」區塊中即可看到目前用量，若您為付費版，可設定在用量達 90% 時寄送通知信。
   

備註：若有更高用量或需要完整功能，請參考介紹頁透過報價單採購。

其他注意事項

API 介紹頁下方有常見問題說明，以下列出其他注意事項：

1. API Token 必須妥善保管：任何知道 API Token 的使用者都能用您的權限透過 API 進行建立連結、查看成效、刪除...等操作。若不慎外流，請點擊「眼睛」符號，再點擊「重置」符號，即可更新 API Token。
   
2. API 呼叫出現偶發錯誤：考量網路因素及免費版 API 有每秒 2 次的呼叫限制，建議自行開發的程式加入 re-try 機制，以避免呼叫失敗時程式出現錯誤。
   
3. 查詢成效出現 401 錯誤：網站免費版會員方案在點擊達 10,000 次後，無法查看成效。建議購買付費版 API，或訂閱網站任一會員方案，即可解鎖限制。
   
4. 可以有多組 API Token 嗎：可以，相同帳號內可用多組 API Token 共享配額；但若要掌握不同部門用量，可以在建立短網址時加上 externalId 參數，後續以 /v4/my/api/usage 查詢即可掌握各 externalId 用量。