跳至正文

Google 輕量搜尋 API

prod-global
GET
/api/v1/google/search/light
API 健康狀態
健康 可用 受限 多數不可用 無資料
正在載入健康狀態...

取得 Google 輕量搜尋 SERP 資料,包括基本結果資料,用於大量監控和快速排名檢查。

標籤: Google

請求參數

名稱必填類型預設值說明
querystringGoogle 搜尋的查詢(例如「咖啡店」、「如何烤蛋糕」)。
pageinteger0結果頁碼。使用 0 表示第一頁,1 表示第二頁,依此類推。
htmlbooleanfalse設為 true 以在結構化資料旁回傳 Google 搜尋結果頁面的原始 HTML。
languagestringen使用兩個字母的代碼設定結果語言(例如:'en' 表示英文,'fr' 表示法文)。請參閱 Google 語言
lrstring使用 'lang_{language_code}' 格式(例如 'lang_en')將結果限制為一種或多種語言。請參閱 Google LR 語言
domainstringgoogle.com用於搜尋的 Google 網域(例如:'google.com'、'google.co.uk')。請參閱 Google 網域
countrystringus設定目標國家代碼(例如:'us'、'uk')以本地化結果。請參閱 Google 國家
crstring將結果限制為來自特定國家的搜尋結果。格式:'countryXX'。請參閱 Google CR 國家
uulestring編碼的位置字串(UULE),用於精確定位 Google 搜尋結果。這是一個進階/技術參數——如果您不熟悉,可以將其留空並省略。
locationstring文字位置名稱(例如「New York, NY」)以在地化搜尋結果。
ludocidstringGoogle 本地商家 CID(地點識別碼)。用於定位特定的 Google 商家檔案/本地清單。進階參數——如果您不熟悉,可以省略。
lsigstring簽名參數(lsig)有時需要於特定的知識圖譜/本地地圖檢視功能。這是進階技術參數——如果您不熟悉,可以留空。
kgmidstring知識圖譜實體/清單 ID(KGMID)用於擷取特定實體的詳細資訊。這是進階技術參數——如果您不熟悉,可以留空。
sistring快取搜尋上下文參數(si)用於重現特定的 Google 搜尋結果檢視/上下文(例如某些知識圖譜分頁)。這是進階技術參數——如果您不熟悉,可以留空。
ibpstring參數(ibp)用於控制特定的 Google UI 展開或渲染模式(常見於本地/商家結果檢視)。這是進階技術參數——如果您不熟悉,可以留空。
udsstring進階篩選權杖(uds)用於特定的 Google 搜尋子篩選。這是進階技術參數,通常由 Google 在篩選選項/結果中提供——如果您不熟悉,可以留空。
tbsstring進階搜尋篩選參數(tbs),用於套用 Google 結果篩選器(例如時間範圍)。這是一個進階參數——如果您不熟悉,可以將其留空。
safestringOFFSafeSearch 篩選設定。

可用值:
- ACTIVE:過濾成人內容。舊版值 active 也接受。
- OFF:停用 SafeSearch 篩選。舊版值 off 也接受。
nfprstringINCLUDE_CORRECTED_RESULTS控制 Google 的自動修正。

可用值:
- INCLUDE_CORRECTED_RESULTS:包含修正後的結果。舊版值 0 也接受。
- EXCLUDE_CORRECTED_RESULTS:排除修正後的結果。舊版值 1 也接受。
filterstring切換相似結果和省略結果的篩選。

可用值:
- DISABLED:停用相似和省略結果篩選。舊版值 0 也接受。
- ENABLED:啟用相似和省略結果篩選。舊版值 1 也接受。

複製請求

bash
curl -X GET "https://api.justserpapi.com/api/v1/google/search/light?query=coffee" \
  -H "X-API-Key: YOUR_API_KEY"
js
const res = await fetch("https://api.justserpapi.com/api/v1/google/search/light?query=coffee", {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
const data = await res.json();
console.log(data);
python
import requests

url = "https://api.justserpapi.com/api/v1/google/search/light"
headers = { "X-API-Key": "YOUR_API_KEY" }
params = {
  "query": "coffee"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())
php
<?php
$url = "https://api.justserpapi.com/api/v1/google/search/light?query=coffee";
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "X-API-Key: YOUR_API_KEY"
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
go
package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	client := &http.Client{}
	req, _ := http.NewRequest("GET", "https://api.justserpapi.com/api/v1/google/search/light?query=coffee", nil)
	req.Header.Set("X-API-Key", "YOUR_API_KEY")
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

回應

正在載入最新回應範例...