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 -X GET "https://serpapi.abcproxy.com/search" \
  -d "engine=google_shopping" \
  -d "q=Coffee" \
  -d "no_cache=false" \
  -d "api_key=YOUR_API_KEY"

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())

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));

<?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();

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

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());
    }
}

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

上一页Google 搜尋 API 下一页Google 本地 API

最后更新于7个月前

hashtagGoogle購物 API

hashtagAPI 詳情

hashtag請求

hashtag回應

hashtag成功 200

hashtag錯誤回應