Google 圖片 API

Google 圖片 API

API 詳情

端點 GET https://serpapi.abcproxy.com/search

説明

我們的 Google圖片API 允許您從 Google 圖片頁面抓取結果。此 API 可透過以下端點存取：/search?engine=google_images。

使用者可以使用 GET 請求查詢以下網址：https://serpapi.abcproxy.com/search?engine=google_images。請前往 工作臺 查看即時互動演示。

---

請求

HTTP 請求

cURL

curl -X GET "https://serpapi.abcproxy.com/search" \
  -d "engine=google_images" \
  -d "q=Coffee" \
  -d "no_cache=false" \
  -d "api_key=YOUR_API_KEY"

Python

import requests

params = {
    "engine": "google_images",
    "q": "Coffee",
    "no_cache": "false",
    "api_key": "YOUR_API_KEY"
}
response = requests.get("https://serpapi.abcproxy.com/search", params=params)
print(response.json())

Node.js

const axios = require('axios');

const params = {
  engine: "google_images",
  q: "Coffee",
  no_cache: "false",
  api_key: "YOUR_API_KEY"
};

axios.get("https://serpapi.abcproxy.com/search", { params })
  .then(response => console.log(response.data));

HTTP

GET /search?engine=google_images&q=Coffee&no_cache=false&api_key=YOUR_API_KEY HTTP/1.1
Host: serpapi.abcproxy.com

PHP

<?php
$client = new \GuzzleHttp\Client();
$response = $client->get('https://serpapi.abcproxy.com/search', [
    'query' => [
        'engine' => 'google_images',
        'q' => 'Coffee',
        'no_cache' => 'false',
        'api_key' => 'YOUR_API_KEY'
    ]
]);
echo $response->getBody();

Golang

package main

import (
    "net/http"
    "io/ioutil"
    "log"
)

func main() {
    client := &http.Client{}
    req, _ := http.NewRequest("GET", "https://serpapi.abcproxy.com/search", nil)
    
    q := req.URL.Query()
    q.Add("engine", "google_images")
    q.Add("q", "Coffee")
    q.Add("no_cache", "false")
    q.Add("api_key", "YOUR_API_KEY")
    req.URL.RawQuery = q.Encode()

    resp, _ := client.Do(req)
    body, _ := ioutil.ReadAll(resp.Body)
    log.Println(string(body))
}

C#

using System;
using System.Net.Http;

class Program
{
    static async Task Main()
    {
        var client = new HttpClient();
        var query = System.Web.HttpUtility.ParseQueryString(string.Empty);
        query["engine"] = "google_images";
        query["q"] = "Coffee";
        query["no_cache"] = "false";
        query["api_key"] = "YOUR_API_KEY";
        
        var response = await client.GetAsync(
            $"https://serpapi.abcproxy.com/search?{query}"
        );
        Console.WriteLine(await response.Content.ReadAsStringAsync());
    }
}

Java

import java.net.*;
import java.io.*;

public class Main {
    public static void main(String[] args) throws Exception {
        String url = "https://serpapi.abcproxy.com/search" +
            "?engine=google_images" +
            "&q=Coffee" +
            "&no_cache=false" +
            "&api_key=YOUR_API_KEY";
        
        HttpURLConnection conn = (HttpURLConnection) new URL(url).openConnection();
        conn.setRequestMethod("GET");
        
        BufferedReader in = new BufferedReader(
            new InputStreamReader(conn.getInputStream())
        );
        String response = in.lines().collect(Collectors.joining());
        System.out.println(response);
    }
}

---

API 參數

搜索查詢

名稱	類型	必填項	描述	範例
q	字符串	是	該參數定義您要搜索的查詢內容。您可以使用在常規Google圖片搜索中會使用的任何內容。	coffee

地理位置

名稱	類型	必填項	描述	範例
location	字符串	否	該參數定義搜索發起的位置。如果有多個位置與請求的位置匹配，我們將選擇最受歡迎的一個。如果您需要更精確的控制，請訪問 /locations.json API。location 和 uule 參數不能一起使用。建議在城市級別指定位置，以模擬真實用戶的搜索。如果省略位置，搜索可能會採用代理的位置。	Korea
uule	字符串	否	使用Google編碼的位置進行搜索。uule 和 location 參數不能一起使用。	-

語言地區

名稱	類型	必填項	描述	範例
google_domain	字符串	否	該參數定義要使用的Google域名。默認值為 google.com。如需查看支持的Google域名完整列表，請訪問 Google域名頁面。	-
gl	字符串	否	該參數定義Google搜索使用的國家/地區。它是一個雙字母國家代碼。（例如，us 代表美國，uk 代表英國，fr 代表法國）。如需查看支持的Google國家/地區完整列表，請訪問 Google國家/地區頁面。	Amgola-ao
hl	字符串	否	該參數定義Google搜索使用的語言。它是一個雙字母語言代碼。（例如，en 代表英語，es 代表西班牙語，fr 代表法語）。如需查看支持的Google語言完整列表，請訪問 Google語言頁面。	Akan-ak

高級篩選器

名稱	類型	必填項	描述	範例
chips	字符串	否	該參數可對圖片搜索進行篩選。它是Google提供的建議搜索字符串。當 ijn = 0 時，suggested_searches 部分會提供 chips。每個建議搜索都會提供 chips 和 serpapi_link 值。	red apple
tbs	字符串	否	（待搜索）該參數定義常規查詢字段中無法實現的高級搜索參數。	-
imgar	字符串	否	該參數定義圖片的設置縱橫比。 s - 方形 t - 豎版 w - 橫版 xw - 全景	-
safe	字符串	否	該參數定義成人內容的篩選級別。它可以設置為 active 或 off，默認情況下Google會模糊顯示明確內容。	active 或 off
nfpr	布爾值	否	當原始查詢拼寫錯誤時，該參數定義是否排除自動更正查詢的結果。可以設置為 1 以排除這些結果，或 0 以包含它們（默認值）。請注意，如果沒有其他可用結果，此參數可能無法阻止谷歌返回自動更正查詢的結果。	true 或 false
filter	布爾值	否	該參數定義 “相似結果” 和 “省略結果” 篩選器是開啟還是關閉。可以設置為 1（默認值）以啟用這些篩選器，或 0 以禁用這些篩選器。	true 或 false

分頁

名稱	類型	必填項	描述	範例
ijn	数值	否	該參數定義 Google圖片 的頁碼。每頁有 100 張圖片。此參數相當於 start（偏移量）= ijn * 100。	2

Serpapi 參數

名稱	類型	必填項	描述	範例
engine	字符串	是	將參數設置為 google_images 以使用Google圖片 API 引擎。	google_images
no_cache	布爾值	否	即使已有緩存版本，該參數也會強制 SerpApi 獲取Google圖片搜索結果。只有當查詢和所有參數完全相同時，才會提供緩存。緩存 1 小時後過期。緩存搜索是免費的，不計入您每月的搜索次數。可以設置為 false（默認值）以允許使用緩存結果，或 true 以禁止使用緩存結果。no_cache 和 async 參數不應一起使用。	true 或 false
api_key	字符串	是	該參數定義要使用的 SerpApi 私鑰。	YOUR_API_KEY

---

響應

成功 200

響應正文

{
  "code": 200,
  "search_metadata":
    {				 
        "raw_html_file":"https://webserp.abcproxy.com/files/6d8b6424c4c37f2d/d3bb5a81-7bb9-4dee-8f75-001b526c0313.html",
        "xray_html_file":"https://webserp.abcproxy.com/files/6d8b6424c4c37f2d/d3bb5a81-7bb9-4dee-8f75-001b526c0313.xray",
        "total_time_taken":"41.3979",
        "id":"d3bb5a81-7bb9-4dee-8f75-001b526c0313",
        "json_endpoint":"https://webserp.abcproxy.com/files/6d8b6424c4c37f2d/d3bb5a81-7bb9-4dee-8f75-001b526c0313.json",
        "created_at":"2025-04-03 11:24:30",
        "google_images_url":"requestUrl",
    },
  "search_parameters":
    {
        "engine":"google_images",
        "api_key":"YOUR_API_KEY",
        "q":"Coffee",
        "reviews":true,
    },
    "images_results":
    [
        {
            "source":"Wikipedia",
            "title":"Coffee - Wikipedia",
            "link":"https://en.wikipedia.org/wiki/Coffee",
            "related_content_id":"Y0hoQW1Kcnc4RXRiV01cIixcIlU2b0pNbkYtZWVWVEFN",
            "related_content_link":"https://en.wikipedia.org/wiki/Coffee",
            "position":1,
            "original":"https://upload.wikimedia.org/wikipedia/commons/e/e4/Latte_and_dark_coffee.jpg",
            "original_width":3200,
            "original_height":2000,
            "thumbnail":"https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRkRapDtN6JSis1bWCnMbqn3pmIEDeDY9t8tg&s",
        },
        ......,
    ],
    "related_searches":
    [
        {
            "thumbnail":"data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/....fQelKVj8ftftq8nrLdUpSttlv/Z",
            "query":"clip art coffee",
            "link":"https://www.google.com/search?sca_esv=e93cf3c.....AxU-MVkFHbpzAUcQrNwCegQIaxAA",
            "highlighted_words":
            [
                "clip art",
            ],
        },
        ......,
    ],
}

響應字段

名稱	類型	備註
search_metadata	對象	包含 計時 和 狀態信息
search_parameters	對象	包含查詢 參數 和 搜索上下文
image_results	對象數組	主要圖片搜索結果區域
related_searches	對象數組	相似搜索結果之後
SuggestedSearch	對象數組	建議搜索內容

錯誤響應

常見錯誤

HTTP 狀態	錯誤代碼	描述
200	400	API 私鑰不能為空
200	401	參數錯誤
200	402	API 私鑰錯誤
200	403	餘額不足
200	404	扣除失敗
200	405	記錄使用次數失敗
200	406	不支持的引擎
200	407	網絡錯誤
200	408	文件未找到
200	409	限制參數錯誤
200	410	構建 URL 錯誤
200	411	查詢最近記錄失敗
200	412	未找到 JSON 文件
200	413	獲取 HTML 錯誤
200	414	HTML 為空
200	429	請求過多

錯誤範例

{
  "code": 400,
  "message": "API Key can not be empty"
}

---