Google 產品 API

Google產品 API

API 詳情

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

説明

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

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

---

請求

HTTP 請求

cURL

curl -X GET "https://serpapi.abcproxy.com/search" \
  -d "engine=google_product" \
  -d "product_id=4887235756540435899" \
  -d "no_cache=false" \
  -d "api_key=YOUR_API_KEY"

Python

import requests

params = {
    "engine": "google_product",
    "product_id": "4887235756540435899",
    "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_product",
  product_id: "4887235756540435899",
  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_product&product_id=4887235756540435899&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_product',
        'product_id' => '4887235756540435899',
        '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_product")
    q.Add("product_id", "4887235756540435899")
    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_product";
        query["product_id"] = "4887235756540435899";
        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_product" +
            "&product_id=4887235756540435899" +
            "&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 參數

搜尋查詢

名稱	類型	必填項	描述	範例
product_id	字符串	是	查詢參數	4887235756540435899

地理位置

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

語言地區

名稱	類型	必填項	描述	範例
google_domain	字符串	否	也就是說，該參數定義要使用的Google網域。預設值為 google.com。前往 Google網域頁面 以獲取支持的 谷歌網域的完整清單。	-
gl	字符串	否	模擬本地搜尋可以提高特定國家/地區搜尋結果的相關性。gl 參數值是兩個字母的國家/地區代碼。前往 Google國家/地區頁面 以獲取支持的 Google 國家/地區的完整清單。	Amgola-ao
hl	字符串	否	主機語言 指定 Google搜尋的使用者介面 (UI) 語言。前往 Google語言頁面 以獲取支持的 谷歌語言的完整清單。	Akan-ak

分頁

名稱	類型	必填項	描述	範例
start	數值	否	搜尋結果的起始索引，指定應包含在搜尋結果中的第一個匹配項。對於 線上賣家 才有效。 此參數已棄用於 評論。請使用 filter 參數搭配 serpapi_pagination.next_page_filter 來分頁瀏覽評論。	0
page	數值	否	此參數用於定義 Google【線上賣家】（Online Sellers）的頁碼。 此參數僅適用於【Online Sellers】。 此參數不建議用於【評論】。若要在評論結果中分頁，請改用 filter 參數搭配 serpapi_pagination.next_page_filter。	10

搜尋類型

名稱	類型	必填項	描述	範例
offers	布爾值	否	用於取得報價結果的參數。取代先前的 sellers=online 結果。 offers 參數不能與 offer_id 參數一起使用。	true或false
specs	布爾值	否	用於取得規格結果的參數。 specs 參數不能與 offer_id 參數一起使用。	true或false
reviews	布爾值	否	用於取得評論結果的參數。 reviews 參數不能與 offer_id 參數一起使用。	true或false

高級過濾器

名稱	類型	必填項	描述	範例
filter	字符串	否	定義評論和報價結果的過濾器、排序和分頁參數。	報價過濾器: freeship:1 只顯示免費運送的產品 ucond:1 只顯示二手產品 scoring:p 按基本價格排序
offer_id	字符串	否	定義用於從線上賣家取得多個報價的 ID，可在 sellers_results.online_sellers 中找到。 offer_id 參數不能與 offers、specs 和 reviews 參數一起使用。	-

SerpApi 參數

名稱	類型	必填項	描述	範例
engine	字串	是	將參數設置為 google_product 以使用 Google 產品 API 引擎。	google_product
no_cache	布爾值	否	即使已有緩存版本，該參數也會強制 SerpApi 獲取 Google 產品搜尋結果。只有在查詢和所有參數完全相同的情況下才會提供緩存。緩存有效期為 1 小時。緩存搜尋是免費的，不會計入您每月的搜尋次數。可以將其設置為 false (預設值) 以允許從緩存中獲取結果，或設置為 true 以禁止從緩存中獲取結果。no_cache 和 async 參數不應一起使用。	true或false
api_key	字串	是	參數定義要使用的 SerpApi 私鑰。	YOUR_API_KEY

---

回應

成功 200

回應主體

{
  "code": 200,
  "search_metadata":
    {				 
        "json_endpoint":"https://webserp.abcproxy.com/files/273eb26205373cfa/f4934f13-c0bc-4476-bff4-1f7bafbf22fb.json",
        "created_at":"2025-04-03 09:40:40",
        "google_product_url":"https://www.google.com/shopping/product/4887235756540435899?ie=UTF-8&sourceid=chrome&qft=pid:4887235756540435899",
        "raw_html_file":"https://webserp.abcproxy.com/files/273eb26205373cfa/f4934f13-c0bc-4476-bff4-1f7bafbf22fb.html",
        "xray_html_file":"https://webserp.abcproxy.com/files/273eb26205373cfa/f4934f13-c0bc-4476-bff4-1f7bafbf22fb.xray",
        "total_time_taken":"10.0920",
        "id":"f4934f13-c0bc-4476-bff4-1f7bafbf22fb",
    },
  "search_parameters":
    {
        "engine":"google_product",
        "api_key":"YOUR_API_KEY",
        "product_id":"4887235756540435899",
        "reviews":true,
    },
  "product_results":
	{
		"description":"Experience lightning-fast loading ... technology With an HDR TV, supported PS5 games display an unbelievably vibrant and lifelike range of colors. 8K output PS5 consoles support 8K Output, so you can play games on your 4320p resolution display.Less",
		"title":"Sony PlayStation 5 - Digital Edition",
		"prices":
			[
				"$449.99",
				"$499.99",
				"$587.00",
			],
		"highlights":
			[
				"The PS5 Digital Edition unleashes new gaming possibilities that you never anticipated",
				"Lightning Speed",
				"Harness the power of a custom CPU, GPU, and SSD with Integrated I/O that rewrite the rules of what a PlayStation console can do",
				"Stunning Games",
			],
		"rating":"4.5",
	},
  "specs_results":
		{
		"Details":
			{
				"Storage Type":"SSD",
				"Connection Type":"Wired",
				"GameStop Exclusive":"false",
				"Compatible Platforms":"PlayStation 5",
				"Storage Capacity":"825GB",
			},
		},
   "reviews_results":
		{
		"ratings":
			[
				{
					"stars":1,
					"amount":802,
				},
				{
					"amount":198,
					"stars":2,
				},
                ......,
			],
		"filters":
			[
				{
					"count":649,
					"label":"Performs well",
				},
				{
					"label":"Attractive",
					"count":100,
				},
				......,
			],
		},
},

響應字段

名稱	類型	描述
search_metadata	對象	包含 時間 和 狀態資訊
search_parameters	對象	包含查詢 參數 和 搜尋上下文
product_results	對象數組	產品搜尋 結果
sellers_results	對象數組	賣家結果
related_products	對象數組	相關產品
specs_results	對象數組	規格 結構
reviews_results	對象數組	評論結果
product_variations	字符串	產品變體

錯誤回應

常見錯誤

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"
}

---