API

API 執行的搜尋與網站相同，並以數據形式返回結果：預設為 JSON，亦可選擇 XML、CSV、TSV、NDJSON 或純文字。所有操作都是讀取——這裏沒有任何操作會建立或更改任何東西。

基本網址 https://api.publicwww.com

一條指令即可

curl -H "Authorization: Bearer $KEY" \
     "https://api.publicwww.com/v1/search?query=%22angular.min.js%22&per_page=3"

{
  "query": "\"angular.min.js\"",
  "page": 1,
  "per_page": 3,
  "total": 278,
  "total_pages": 93,
  "returned": 3,
  "truncated": false,
  "took_ms": 2,
  "results": [
    { "domain": "imgbox.com", "url": "https://imgbox.com/", "rank": 4187, "ranked": true }
  ]
}

端點

端點	方法	用途
`/v1/search`	GET, POST	執行搜尋。另見參數、格式。
`/v1/account`	GET	方案、配額及限制。不消耗任何配額。
`/v1/clusters`	GET, POST	已保存的網站列表：可從搜尋或列表建立、互相結合，並從網頁原始碼提取聯絡資料及各種 ID。另見網域集。
`/mcp`	POST	供 AI 助理及代理使用的 MCP 伺服器：以工具形式提供搜尋及網域集，使用同一個 Token。
`/`	GET	API 的自我描述，包括錯誤代碼。無須 Token。
`/openapi.json`	GET	同樣內容的 OpenAPI 3.1 描述，可匯入 Postman、n8n、Make、Power Automate 等工具。無須 Token。

沒有獨立的匯出端點。大量匯出就是使用較大 per_page 的 /v1/search；付費方案最多可達一百萬項，回應會一邊產生一邊以串流傳送。

API 的承諾

結果絕不會被悄悄減少。瀏覽器的每日配額用完時，網站會靜靜退回免費方案的限制，顯示較少結果。腳本察覺不到這種變化，所以 API 會改為返回錯誤——429 quota_exceeded，而不是一個看似完整、實則不全的回應。
不完整的回應會標明不完整——所有格式都會在內容中標示 truncated，並在標頭中加上 X-Truncated。
沒有排名的網站會如實標明——rank: null 及 ranked: false，絕不會返回內部佔位值，以免用戶端誤以為是一個真實但極大的排名。
告訴您要等，好過讓您乾等。請求太頻密時，API 會立即返回回應並附上 Retry-After，而不是一直佔住連線。

取得 Token

在您的帳戶頁面建立 Token，或讓應用程式透過 OAuth 2.1 代您取得。必須擁有付費方案；請參閱價格。呼叫舊版 ?export= 網址的現有腳本可繼續照常運作——請參閱舊版匯出網址。

下一頁身份驗證