LargitData 開發者中心

LargitData 提供兩種可程式化介接的服務。公開內容 API 免費、唯讀、不需要金鑰， 回傳的就是本站以 HTML 發佈的產品目錄、知識中心索引與部落格內容。 商用資料 API，也就是社群媒體 API 與跨境電商數據 API，屬於簽約交付的服務， 以 API 金鑰認證。前者本頁即可完整使用，後者請從索取試用金鑰開始。

快速開始

不必註冊、不必金鑰、不必安裝 SDK，一行就能拿到資料：

curl -s https://www.largitdata.com/api/v1/products | jq '.data[].id'

想知道有哪些資源可用，從服務索引開始：

curl -s https://www.largitdata.com/api/v1/

下面所有端點的機器可讀規格放在 /openapi.json （另有 YAML 版），可直接餵給程式碼產生器：

npx @openapitools/openapi-generator-cli generate \
  -i https://www.largitdata.com/openapi.json \
  -g python -o ./largitdata-client

端點清單

基底網址：https://www.largitdata.com/api/v1/。所有端點僅支援 GET （同時回應 HEAD 與 OPTIONS），並開放跨來源讀取（CORS）。

lang 可填 zh-tw（預設）、en 或 ja； page_size 範圍 1 到 100，預設 50。

目錄中的產品

回應格式

所有成功回應使用同一組外層結構：集合型端點帶 meta 與 links， 單筆端點只有 data。

{
  "data": [ { "id": "infominer", "name": "InfoMiner ...", "url": "https://..." } ],
  "meta": { "total": 9, "page": 1, "page_size": 50, "total_pages": 1, "lang": "zh-tw" },
  "links": {
    "self": "https://www.largitdata.com/api/v1/products?page=1",
    "next": null,
    "prev": null,
    "documentation": "https://www.largitdata.com/developers/"
  }
}

翻頁時持續跟隨 links.next，直到它變成 null。 回應可快取 10 分鐘，並帶有 X-API-Version 標頭。

錯誤與錯誤碼

錯誤一律不是 HTML。/api/ 底下所有失敗都回傳 RFC 9457 的 application/problem+json，帶有穩定的 code 以及說明如何修正的 hint：

{
  "type": "https://www.largitdata.com/developers/#error-invalid_parameter",
  "title": "Bad Request",
  "status": 400,
  "code": "invalid_parameter",
  "detail": "page_size=9999 is outside the supported range.",
  "instance": "/api/v1/pages",
  "hint": "page_size must be an integer between 1 and 100.",
  "documentation_url": "https://www.largitdata.com/developers/",
  "parameter": "page_size"
}

非 API 路徑若不存在，會回傳真正的 HTTP 404。 送出 Accept: text/markdown 時，回傳的是一份列出後續查找位置的 markdown 文件， 而不是有版面的 HTML 錯誤頁。

機器可讀資源

以下資源讓程式與 AI agent 不需爬取網頁就能導覽本站：

商用 API 與認證

LargitData 有兩項服務以簽約方式交付資料，不從本站提供，認證方式為 X-API-Key 請求標頭：

curl -H "X-API-Key: $LARGITDATA_API_KEY" https://<專屬主機>/...

索取試用金鑰請來信 [email protected]， 並附上：需要的平台、關鍵字或品類範圍、預估請求量、希望的交付格式。 我們會回覆試用金鑰、對應範圍的端點文件，以及介接協助。

合理使用與支援

• 公開內容 API 目前未設速率限制。請將頻率控制在每秒約 1 次以內， 並設定可辨識的 User-Agent，讓我們在調整前能先聯絡到你。
• 回應可快取 10 分鐘，請遵循 Cache-Control 而非持續輪詢。
• API 回傳的內容仍受網站條款規範，轉載時請標註來源為 LargitData。
• 破壞相容性的變更會改用新的版本前綴（/api/v2/）， /api/v1/ 的約定維持不變。