Google 購物 API

Google購物 API

API 詳情

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

説明

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

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

---

請求

HTTP 請求

---

cURL

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

Python

import requests

params = {
    "engine": "google_shopping",
    "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_shopping",
  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_shopping&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_shopping',
        '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_shopping")
    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_shopping";
        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_shopping" +
            "&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	字符串	否	參數定義您希望搜尋從哪裡發起。如果有多個 location 與請求的位置匹配，我們將選擇最受歡迎的一個。如果您需要更精確的控制，請前往 /locations.json API。location 和 uule 參數不能一起使用。建議在城市級別指定位置，以模擬真實用戶的搜尋。如果省略 location，搜尋可能會採用代理的位置。	Korea
uule	字符串	否	使用Google編碼的位置進行搜尋。uule 和 location 參數不能一起使用。	-

語言地區

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

高級過濾器

名稱	類型	必填項	描述	範例
tbs	字符串	否	(要搜尋的) 參數定義了在常規查詢欄位中無法實現的高級搜尋參數。	-
shoprs	字符串	否	該參數定義了設置搜尋過濾器的輔助 ID。要正確應用搜尋過濾器，該參數必須與更新後的 q 參數結合使用，該參數現在包含應用於原始查詢旁邊的過濾器名稱。	sugar free
direct_link	布爾值	否	此參數確定搜尋結果是否應包含每個產品的直接連結。預設值為 false，如果您需要直接連結，請將其設置為 true。 由於 Google 的新佈局，結果 不保證 每個產品都有直接連結。	true或false

分頁

名稱	類型	必填項	描述	範例
start	數值	否	搜尋結果的起始索引，指定應包含在搜尋結果中的第一個匹配項。對於新佈局，不建議使用此參數。為了輕鬆準確地檢索分頁結果，建議遵循 serpapi_pagination.next 中提供的連結。	0
num	數值	否	限制結果數量 指定要在搜尋結果頁面中顯示的搜尋結果數量。使用 num 可能會引入延遲，和/或阻止包含特殊結果類型。除非嚴格需要增加每頁的結果數量，否則最好省略此參數。 結果 不保證 具有 num 中指定的結果數量	10

SerpApi 參數

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

---

回應

成功 200

回應主體

{
  "code": 200,
  "search_metadata":
    {
        "total_time_taken":"11.6243",
        "id":"dd8694ab-d5fd-4729-8714-3772d23ae7aa",
        "json_endpoint":"https://webserp.abcproxy.com/files/3b618e3a516b13fa/dd8694ab-d5fd-4729-8714-3772d23ae7aa.json",
        "created_at":"2025-04-02 10:20:15",
        "google_shopping_url":"https://www.google.com/search?q=coffee&tbm=shop",
        "raw_html_file":"https://webserp.abcproxy.com/files/3b618e3a516b13fa/dd8694ab-d5fd-4729-8714-3772d23ae7aa.html",
        "xray_html_file":"https://webserp.abcproxy.com/files/3b618e3a516b13fa/dd8694ab-d5fd-4729-8714-3772d23ae7aa.xray",
   },
  "search_parameters":
    {
        "engine":"google_shopping",
        "q":"Coffee",
        "location_requested":"Austin, Texas, United States",
        "location_used":"Austin,Texas,United States",
        "google_domain":"google.com",
        "api_key":"YOUR_API_KEY",
        "hl":"en",
        "gl":"us",
    }
    "filters":
    [
        {
            "input_type":"checkbox",
            "options":
            [
                  	{
                    "text":"Поблизу",
                    "link":"https://www.google.com/searc30YMYAli3yx9gAg&......UKEwjN8LjVpLiMAxXoLEQIHaoZCcAQ268JKAB6BAgfEAQ",
                    },
                    {
                    "text":"Розпродаж",
                    "link":"https://www.google.com/searc....cIHaoZCcAQ268JKAF6BAgfEAU",
                    },
                	 ......
            ],
            ......
     },
     "shopping_results":
    [
        {
            "reviews":15,
            "title":"Folgers Coffee Ground Classic Roast",
            "product_id":"16914877625280977865",
            "ratting":4.6,
            "source":"Walgreens.com",
            "price":"5,49 USD",
            "extracted_price":5,
            "position":1,
            "product_link":"https://www.google.com/shopping/product/16914877625280977865?gl=us",
        },
        .......
    ],
  }
}

響應字段

名稱	類型	描述
search_metadata	對象	包含 時間 和 狀態資訊
search_parameters	對象	包含查詢 參數 和 搜尋上下文
inline_shopping_results	對象數組	內嵌 購物 結果
shopping_results	對象數組	購物結果
related_shopping_results	對象數組	相關 購物 結果
categories	對象數組	分類
featured_shopping_results	對象數組	精選購物結果
pagination	對象	分頁 資訊

錯誤回應

常見錯誤

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

---