沃爾瑪搜尋API

API 详情

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

描述

我們的沃爾瑪搜尋引擎結果 API 允許您從沃爾瑪搜尋引擎結果頁面抓取結果。該 API 可透過以下端點訪問:/search?engine=walmart。使用者可以透過 GET 請求來查詢 https://serpapi.abcproxy.com/search?engine= walmart 。可前往 工作臺 觀看實時且互動的示範。


請求方式

HTTP 请求

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

API 參數

搜尋查詢

名稱
類型
必填
說明
範例

query

字符串

參數定義搜尋關鍵字。您可以使用任何在一般沃爾瑪搜尋中會使用的字詞。必須提供 querycat_id 參數之一。

Coffee

進階沃爾瑪參數

名稱
類型
必填
說明
範例

sort

字符串

參數定義排序方式。 可設為: price_low(價格由低到高) price_high(價格由高到低) best_seller(熱銷) best_match(最相關) rating_high(評價最高) new(最新商品)

price_low

soft_sort

布爾值

啟用相關性排序。沃爾瑪預設依相關性排序並使用排序選項。設為 false 可停用相關性排序。

false

進階篩選

名稱
類型
必填
說明
範例

cat_id

字符串

沃爾瑪搜尋的分類代碼。(如:0 為所有部門,976759_976787 為「曲奇餅」等)。必須提供 querycat_id

976759_976787

facet

字符串

依商品屬性過濾項目。格式為由 `

store_id

字符串

依指定門市 ID 過濾商品。完整支援門市列表請見 沃爾瑪門市位置

5

min_price

字符串

價格區間下限。

1

max_price

字符串

價格區間上限。

999

spelling

布爾值

啟用拼字修正。true(預設)為啟用,false 為停用拼字修正。

truefalse

nd_en

布爾值

僅顯示支援隔日達配送的結果。設為 true 啟用,預設為 false 停用。

truefalse

進階沃爾瑪參數

名稱
類型
必填
說明
範例

page

字符串

用於取得指定頁數的商品結果。例如 1 為第1頁,2 為第2頁,依此類推。最大頁數為 100

1

SerpApi 參數

名稱
類型
必填
說明
範例

engine

字符串

設定為 walmart 以使用 Walmart 搜尋 API 引擎。

walmart

no_cache

布爾值

強制 SerpApi 抓取最新結果,不使用快取。快取在相同查詢與參數下有效 1 小時。預設為 false,設為 true 禁止使用快取。

truefalse

api_key

字符串

SerpApi 私有 API 金鑰。

123


回應

成功 200

回應內容

回應欄位

欄位
類型
說明

search_parameters

對象

包含查詢參數及搜尋上下文

search_metadata

對象

包含時間與狀態資訊

url

字符串

網址


錯誤回應

常見錯誤

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

請求過多

錯誤範例


最后更新于