跳轉到主要內容
Google SERP（Search Engine Results Page）是使用者在 Google 搜尋引擎中輸入查詢後看到的結果頁面。它顯示自然搜尋結果、廣告、精選摘要、知識圖譜以及圖片、影片等多種內容，旨在為使用者提供最相關的資訊。 本文將詳細介紹 Google SERP API，它可以提供在 Google 搜尋引擎中輸入查詢取得結果，結果的內容也包含了許多類型，例如精選摘要、知識圖譜以及圖片等多種結果。 本文檔會介紹 Google SERP API 的串接說明。

​
申請流程

要使用 Google SERP API，首先到 Ace Data Cloud 控制台 取得您的 API Token，留作備用。 如果你尚未登入或註冊，會自動跳轉到登入頁面邀請你註冊和登入，完成後會自動返回目前頁面。 一個 API Token 即可呼叫平台所有服務，無需為每個服務單獨申請。 首次申請會贈送免費額度，可免費體驗；額度不足時可在 控制台 儲值通用餘額。
📘 完整文件：Google SERP API →

​
基本使用

輸入關鍵字與搜尋資源類型即可取得結果：用 query 傳遞關鍵字，用 type 選擇網頁、圖片、新聞等搜尋類型；該介面無需傳遞 model。 例如查找：關於「apple inc」的資訊，我們接下來就可以在介面上填寫對應的內容，如圖所示：

可以看到這裡我們設定了 Request Headers，包括：
  • accept：想要接收何種格式的回應結果，這裡填寫為 application/json，即 JSON 格式。
  • authorization：呼叫 API 的金鑰，申請之後可以直接下拉選擇。
另外設定了 Request Body，包括：
  • type：搜尋資源的類型，目前只支援六種類型，預設是 search。
  • query：搜尋的關鍵字。
  • country：自訂搜尋結果所在的國家，預設是美國（US）。
  • language：自訂搜尋結果的語言，預設是英文（en）。
  • range：自訂搜尋結果的時間範圍，預設是沒有限制。
  • number：自訂搜尋結果的分頁頁面大小，預設是 10。
  • page：自訂搜尋結果的分頁頁數，預設是 1。
選擇之後，可以發現右側也產生了對應程式碼，如圖所示：

點擊「Try」按鈕即可進行測試，如上圖所示，這裡我們就得到了如下結果：
回傳結果一共有多個欄位，介紹如下：
  • knowledge_graph，搜尋結果的知識圖譜。
  • organic，搜尋結果的詳細資訊。
  • people_also_ask，與搜尋關鍵字相關的問題。
  • related_searches，針對搜尋關鍵字的相關搜尋。
可以看到，這裡回傳的結果中有一個 organic 欄位，它主要包含了搜尋關鍵字的結果。 另外如果想產生對應的串接程式碼，可以直接複製產生，例如 CURL 的程式碼如下：
Python 的串接程式碼如下：

​
自訂搜尋類型

如果您自訂搜尋資源的類型，我們可以修改參數 type，它分別包含了一般資源 search、圖片資源 images、新聞資源 news、地圖資源 maps、地區資源 places、影片資源 videos，本文將以影片資源 videos 做一個示範。 下面我們來示範具體的操作。 首先，將 type 參數設定為 videos，並正常傳遞 query 參數，如圖所示：

對應程式碼如下：
可以得到如下回應：
回傳結果一共有多個欄位，介紹如下：
  • news，搜尋結果中的影片資訊列表。
可以看到，這裡回傳的結果中有一個 videos 欄位，它主要包含了搜尋關鍵字的結果。

​
自訂搜尋資源所在國家

該介面也支援限定搜尋結果所在的國家，我們可以新增 country 參數來限定國家，輸入的參數為國家的縮寫，例如 cn（China）、us（United States），本文將以 China 做如下範例，以下為具體資訊：

輸出效果如下：
可以看到，結果中是在中國國家的搜尋結果，具體的內容與上文是類似的。

​
自訂搜尋結果語言

我們還可以自訂搜尋結果的語言，這裡我們額外新增 language 欄位，內容為 zh-cn，其中它指的是簡體中文的語言，同時還支援其他語言，但必須輸入語言的簡寫，例如 en（English）、fr（French）、zh-cn（Chinese（Simplified））等語言，如圖所示：

對應程式碼如下：
執行結果如下：
可以看到這裡顯示的結果都是簡體中文的語言，結果的內容與上文類似。

​
自訂搜尋結果時間範圍

本文還可以自訂搜尋結果的時間範圍，包括五種，分別是 qdr:h（過去一小時）、qdr:d（過去一天）、qdr:w（過去一週）、qdr:m（過去一個月）、預設無限制，我們可以透過 range 傳遞對應的時間範圍即可，例如這裡設定為 qdr:d，這樣表示搜尋過去一天的結果，所以輸入如下：

對應的程式碼如下：
執行結果如下：
可以看到，我們就成功得到了過去一天的搜尋結果，結果內容與上文類似。

​
自訂搜尋結果分頁

本 API 還支援自訂搜尋結果的分頁展示，number 和 page 表示分頁的頁面大小和頁數，本文將設定一頁裡面有 20 個搜尋結果的形式來進行分頁展示，具體的資訊如圖所示：

注意：當每頁結果超過 10 個時，扣除的點數會翻倍。
程式碼如下：
執行結果如下：
可以看到，這裡它對搜尋結果進行了分頁展示，一頁裡面展示了 20 條結果，結果的內容與上文類似。