谷歌搜索API

基礎信息

接口說明：透過API從Google獲取即時搜尋資料。

請求地址：https://scraperapi.thordata.com/request

請求方式： POST

請求參數

Headers：

參數名稱	參數类型	是否必須	描述
token	string	是	請登入 儀表板 - 帳號 - 設定 以查看您的 token

Body：

參數名稱	參數类型	是否必須	描述
q	string	是	定義用於爬取的搜尋查詢（預設：q=pizza）。
json	string	否	此參數定義爬取結果的輸出格式： json=1 表示 JSON 格式， json=2 表示同時輸出兩種格式， json=3 表示 HTML 格式。
url	string	是	參數定義爬取時使用的網域，預設為 google.com。 如需修改或查看完整支援的網域列表，請參考 Google 網域頁面。
gl	string	否	指定搜尋結果的地區/國家設定（支援代碼請參閱 Google 國家列表）。
hl	string	否	設定搜尋結果的介面語言 完整語言代碼列表請參閱：Google 語言代碼表
cr	string	否	使用|分隔符限定搜尋結果至特定國家 （需搭配 gl 參數確保介面語言與內容語言一致） gl（介面語言）與 cr（國家限制）可同時使用 實際效果以 cr 參數為優先準則
lr	string	否	使用 lang_XX 語言代碼篩選搜尋結果（若同時使用 hl 參數，將優先採用本設定） 注意： hl（介面語言）與 lr（語言篩選）可同時使用 實際效果以 lr 參數為優先準則
location	string	否	模擬從精確位置進行的搜索。必須與uule配對使用。
uule	string	否	此參數會將選定位置以 Base64 編碼格式處理，需與 location 參數搭配使用。 所有可用的 uule 參數值可在此下載 CSV 檔案
tbm	string	否	定義搜索結果類型： tbm=isch – 圖片 tbm=shop – 購物 tbm=nws – 新聞 tbm=vid – 影片
start	string	否	設定搜尋結果的分頁起始點。範例： start=0（預設值） - 第一頁結果 start=20 - 第二頁結果 start=40 - 第三頁結果，以此類推
num	string	否	此參數設定每頁顯示的搜尋結果數量上限。例如： num=20（預設值） - 顯示 20 項結果 num=50 - 顯示 50 項結果，以此類推
safe	string	否	此參數用於設定是否過濾成人內容。選項如下： active（啟用） - 過濾成人內容 off（關閉） - 不過濾成人內容
ludocid	string	否	此參數用於定義您要爬取的 Google 商家檔案（Google My Business）ID（CID），亦稱為 Google 地點 ID。
kgmid	string	否	此參數用於直接擷取 Google 知識圖譜（Knowledge Graph）中特定條目的加密數據，將覆蓋標準搜尋參數並返回結構化結果。
ibp	string	No	此參數用於控制特定元素的版面渲染與展開效果，例如搭配 ludocid 實現知識圖譜的擴展搜尋互動。
tbs	string	否	此參數用於時間/類型篩選（支援複雜條件），例如： tbs=qdr:d - 僅顯示 24 小時內的內容 tbs=qdr:h - 過去 1 小時 tbs=qdr:w - 過去 1 週 tbs=qdr:m - 過去 1 個月 tbs=qdr:y - 過去 1 年
nfpr	string	否	此參數用於控制是否停用搜尋關鍵詞的自動校正功能： nfpr=1 - 停用自動校正 nfpr=0 - 啟用自動校正
filter	string	否	此參數用於控制搜尋結果的重複內容篩選功能： 1 - 啟用去重 0 - 停用去重

響應示例

{
    "spider_parameter": {
        "engine": "google",
        "q": "pizza"
    },
    "total": {
        "value": "About 2,240,000,000 results (0.30 seconds) "
    },
    "search_metadata": {
        "created_at": "2025-06-21 14:08:06",
        "id": "xxx",
        "url": "https://www.google.com/search?q=pizza"
    },
    "result":{}

參數名稱	參數类型	是否必須	描述
spider_parameter	object	是	搜尋引擎參數配置
engine	string	是	搜尋引擎類型
q	string	是	搜尋關鍵字
total	object	是	總搜尋結果資訊
value	string	是	結果數量和時間
search_metadata	object	是	搜尋的元數據
created_at	string	是	搜尋的時間戳記
id	string	是	唯一任務ID
url	string	是	搜尋請求的完整URL
result	string	是	返回結果