Exabase Link Preview icon

Exabase Link Preview

Exabase Link Preview 是一款 developer API,可擷取任何 URL 的標題、描述、圖片、favicon 等預覽中繼資料,並回傳結構化 JSON,方便建立豐富連結卡片與預覽。

Exabase Link Preview

概覽

Exabase Link Preview 是一款 developer API,可從 URL 擷取豐富中繼資料,並以結構化 JSON 回傳。它旨在支援連結卡片與其他預覽介面,而不需要你的應用程式自行爬取頁面或建立額外資源。

此 API 會回傳預覽常用欄位:頁面標題、描述、預覽圖片、favicon、網站名稱、canonical URL、語言地區,以及相關圖片或圖示中繼資料。產品頁將其定位為單一 GET 請求即可即時運作,包含以 JavaScript 呈現的頁面。

功能特色

結構化預覽中繼資料

回傳一個精簡的 JSON 物件,包含建立豐富連結卡片所需的欄位,例如標題、描述、圖片、favicon、網站名稱、canonical URL、語言地區與來源 URL。

單一 GET 請求流程

一次請求即可擷取頁面並提取 Open Graph 標籤及相關中繼資料,讓應用程式不必自行解析 HTML。

支援 JavaScript 呈現頁面

文件指出 API 可即時擷取頁面,包括以 JavaScript 呈現的內容。

豐富的資產細節

提供圖片與 favicon 的詳細資訊,在可取得時包含尺寸、MIME 類型與檔案大小,有助於版面配置與驗證。

即時 JSON 回應

回傳同步回應,適合在應用程式中立即渲染連結卡片或預覽。

清楚的無預覽處理

文件註明當某個 URL 無法擷取預覽資料時會回傳 404,為不支援的頁面提供明確的失敗訊號。

使用情境

  • 聊天與訊息預覽

    當使用者在聊天、訊息或協作軟體中貼上 URL 時,顯示豐富預覽。API 會提供卡片式呈現所需的標題、描述、圖片與 favicon。

  • CMS 連結卡片

    當編輯者在編輯工具或 CMS 工作流程中新增連結時,自動生成預覽卡片。這可免除手動輸入標題與縮圖資料的需求。

  • 書籤管理器

    當使用者儲存 URL 時,以頁面中繼資料填充書籤資料庫。回傳的標題、描述與圖片可用來以視覺化方式整理已儲存的連結。

  • 發佈前連結驗證

    在社群排程工具中發佈前,先檢查 URL 的呈現方式。API 回傳的圖片尺寸可協助偵測可能不符合預期長寬比的預覽。

  • 僅中繼資料工作流程

    當你需要預覽資訊但不需要完整頁面內容時,可將回應作為輕量級中繼資料來源。產品頁會在需要完整內容擷取時引導使用者改用 Exabase Extract。

Pros and Cons

Pros

  • 可從單一 URL 回傳建立連結卡片所需的核心欄位。
  • 根據產品頁與文件,支援以 JavaScript 呈現的頁面。
  • 除了文字欄位之外,還包含圖片與 favicon 中繼資料。
  • 提供清楚的 API 合約,具備文件化欄位與錯誤處理。
  • 可直接使用,不必為該 URL 建立額外資源。

Cons

  • 文件表示某些 URL 沒有可用的預覽資料,這種情況下端點會回傳 404。
  • 首頁說明超過每月免費額度後會收取名義費用,因此使用並非無限制。
  • 此產品聚焦於連結中繼資料,而非完整頁面擷取;網站會引導使用者在需要結構化頁面內容時改用 Exabase Extract。

FAQ

Link Preview API 會回傳什麼?

這是一個單次請求的 API,接受一個 URL,並回傳結構化的連結中繼資料,例如標題、描述、圖片、favicon、網站名稱、canonical URL 和語言地區。文件將其描述為同步回應。

我要如何驗證請求?

開發者指南顯示,API 透過 Exabase API 金鑰進行存取,並在 `X-Api-Key` 標頭中傳送。一般文件也指出,API 金鑰不應暴露在用戶端程式碼中。

端點格式是什麼?

文件將端點描述為 `GET /v2/link`,並示範帶有 `url` 查詢參數的請求範例。產品頁也將其呈現為回傳 JSON 的 GET 請求。

Link Preview 是免費使用的嗎?

產品頁表示此服務每月最多可免費使用 20,000 次連結預覽,超過後會收取 0.01 credits 的象徵性費用。定價頁也指出 Exabase 有免費方案與付費用量模式,但 Link Preview 頁面提供了最明確的使用上限。

它能處理依賴 JavaScript 的頁面嗎?

可以。產品頁表示 API 會即時擷取並解析頁面,包括以 JavaScript 呈現的頁面,而文件也說明回應是同步的。若無法擷取任何預覽資料,則會回傳 404。

Quick Facts

類別
Developer Tool
產品類型
連結預覽 API
端點
GET /v2/link
驗證方式
透過 X-Api-Key 的 API key
免費使用量
產品頁每月 20,000 次連結預覽
輸出
JSON 預覽中繼資料