Google 圖片 搜尋 API

prod-global

GET

/api/v1/google/images/search

API 健康狀態

健康 可用 受限 多數不可用 無資料

正在載入健康狀態...

獲取 Google 圖片搜尋資料，包括圖片 URL 和中繼資料，用於過濾後的圖片發現，適用於研究與監控工作流程。

標籤: Google 圖片

請求參數

名稱	必填	類型	預設值	說明
query	是	string		圖片的搜尋查詢（例如 '山景', '豪華汽車'）。
html	否	boolean	false	設為 true 以回傳 Google 搜尋結果頁面的原始 HTML 以及結構化資料。
page	否	integer	0	結果頁碼。使用 0 表示第一頁，1 表示第二頁，依此類推。
domain	否	string	google.com	用於搜尋的 Google 網域（例如 'google.com'、'google.co.uk'）。請參閱 Google 網域。
country	否	string	us	設定目標國家代碼（例如 'us'、'uk'）以本地化結果。請參閱 Google 國家。
cr	否	string		將結果限制在特定國家的搜尋結果。格式：'countryXX'。請參閱 Google CR 國家代碼。
language	否	string	en	使用兩個字母的代碼設定結果語言（例如 'en' 表示英文，'fr' 表示法文）。請參閱 Google 語言。
lr	否	string		使用 'lang_{language_code}' 格式（例如 'lang_en'）將結果限制為一種或多種語言。請參閱Google LR 語言。
uule	否	string		編碼位置字串 (UULE)，用於精確定位 Google 搜尋結果。這是一個進階/技術參數 — 如果您不熟悉，可以留空並省略。
period_unit	否	string		近期圖片結果的時間單位。 可用值： - SECOND：秒。舊版值 s 也接受。 - MINUTE：分鐘。舊版值 n 也接受。 - HOUR：小時。舊版值 h 也接受。 - DAY：天。舊版值 d 也接受。 - WEEK：週。舊版值 w 也接受。 - MONTH：月。舊版值 m 也接受。 - YEAR：年。舊版值 y 也接受。
period_value	否	string		與 'period_unit' 一起使用的時間持續時間值（例如，15 表示 15 天）。預設值：1。
start_date	否	string		用於將圖片限制在時間範圍內的開始日期。格式：'YYYYMMDD'（例如 '20241201'）。
end_date	否	string		限制圖片時間範圍的結束日期。格式：'YYYYMMDD'（例如 '20241231'）。
chips	否	string		用於篩選圖片的額外建議搜尋詞（chips）。值來自先前的回應。
tbs	否	string		進階搜尋篩選參數 (tbs)，用於套用 Google 結果篩選器（例如時間範圍）。這是一個進階參數 — 如果您不熟悉，可以留空。
imgar	否	string		依圖片長寬比篩選。 可用值： - SQUARE：方形圖片。也接受舊版值 s。 - TALL：長形圖片。也接受舊版值 t。 - WIDE：寬形圖片。也接受舊版值 w。 - PANORAMIC：全景圖片。也接受舊版值 xw。
imgsz	否	string		依圖片大小篩選。 可用值： - LARGE：大型圖片。也接受舊版值 l。 - MEDIUM：中型圖片。也接受舊版值 m。 - ICON：圖示大小圖片。也接受舊版值 i。
image_color	否	string		依主色篩選圖片（例如 'red'、'blue'、'bw' 代表黑白、'trans' 代表透明）。
image_type	否	string		依圖片類型篩選。支援的值：'face'、'photo'、'clipart'、'lineart'、'animated'。
licenses	否	string		依使用權限與授權篩選。 可用值： - FREE_TO_USE：免費使用。也接受舊版值 f。 - COMMERCIAL_USE：商業用途。也接受舊版值 fc。 - CREATIVE_COMMONS：創用 CC。也接受舊版值 cl。
safe	否	string	OFF	SafeSearch 篩選設定。 可用值： - ACTIVE：過濾成人內容。也接受舊版值 active。 - OFF：停用 SafeSearch 篩選。也接受舊版值 off。
nfpr	否	string	INCLUDE_CORRECTED_RESULTS	控制 Google 的自動修正。 可用值： - INCLUDE_CORRECTED_RESULTS：包含修正後的結果。也接受舊版值 0。 - EXCLUDE_CORRECTED_RESULTS：排除修正後的結果。也接受舊版值 1。
filter	否	string		切換類似結果與省略結果的篩選。 可用值： - DISABLED：停用類似與省略結果篩選。也接受舊版值 0。 - ENABLED：啟用類似與省略結果篩選。也接受舊版值 1。

複製請求

cURL

curl -X GET "https://api.justserpapi.com/api/v1/google/images/search?query=coffee" \
  -H "X-API-Key: YOUR_API_KEY"

JavaScript

const res = await fetch("https://api.justserpapi.com/api/v1/google/images/search?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/images/search"
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/images/search?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/images/search?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))
}

回應

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