EBay 搜尋 API
API 詳情
請求端點
GET https://serpapi.abcproxy.com/search
**說明 **
我們的 EBay 搜尋引擎結果 API 允許您從 EBay 搜尋引擎結果頁面抓取結果。此 API 可透過以下端點存取:
/search?engine=ebay
。使用者可以使用
GET
請求查詢以下網址:https://serpapi.abcproxy.com/search?engine=ebay
。請前往 工作臺 查看即時互動演示。
請求方式
HTTP 請求範例
curl -X GET "https://serpapi.abcproxy.com/search" \
-d "engine=ebay" \
-d "_nkw=Coffee" \
-d "no_cache=false" \
-d "api_key=YOUR_API_KEY"
API 參數說明
搜尋參數
_nkw
字符串
是
搜尋關鍵字,與 eBay 搜尋欄中使用的字串相同。如果指定 category_id
,此參數可為選填。
Coffee
地區與語言設定
分頁參數
_pgn
字符串
否
用於分頁的參數,表示要抓取的頁碼,例如 1
(預設)為第一頁,2
為第二頁,3
為第三頁,以此類推。
1
_ipg
字符串
否
指定每頁要返回的最大結果數。可選擇 25
、50
(預設)、100
或 200
筆結果。
50
進階篩選條件
_blrs
字符串
否
當查詢拼錯並自動更正時,此參數用於排除自動更正後的查詢結果。建議值為 spell_auto_correct
。若希望包含自動更正的結果,則不使用此參數。注意:若無其他可用結果,即使設置了此參數,eBay 仍可能返回自動更正的結果。
spell_auto_correct
show_only
字符串
否
定義可用於結果的過濾器列表。
可用選項(區分大小寫): Complete
- 已完成商品
Sold
- 已售出商品
FR
- 免費退貨
RPA
- 接受退貨
AS
- 授權賣家
Savings
- 折扣與優惠
SaleItems
- 特價商品
Lots
- 批量出售
Charity
- 慈善捐贈
AV
- 真偽保證
FS
- 免運費
LPickup
- 本地自取 可用逗號結合多個過濾條件,如:Sold,FS
。
-
buying_format
字符串
否
定義購買格式的過濾條件。
可用選項(區分大小寫):
Auction
- 拍賣
BIN
- 立即購買
BO
- 接受議價
-
進階 eBay 參數
_udlo
字符串
否
定義結果中商品的最低價格(例如 10
表示只返回價格高於 10 的商品)。
10
_udhi
字符串
否
定義結果中商品的最高價格(例如 20
表示只返回價格低於 20 的商品)。
20
_dmd
字符串
否
定義結果的視覺顯示佈局。可選擇 Grid
(格狀)或 List
(列表)。
-
category_id
字符串
否
指定搜尋集中的類別 ID。ID 可在 JSON 回傳結果的 categories
陣列中找到。
可單獨使用此參數而不需指定 _nkw
。
categories[1].id
_stpos
字符串
否
指定郵遞區號,用以篩選指定區域的運送商品。
-
LH_ItemCondition
字符串
否
此參數用來定義一個或多個商品的狀況條件,以限制搜尋結果。每個商品狀況以數字 ID 表示,例如 1000
代表「全新(New)」。若要指定多個狀況,請使用 `
作為分隔符,例如:
1000
SerpApi 專屬參數
engine
字符串
是
設定為 ebay
以使用 Ebay Search API 引擎。
ebay
no_cache
布爾值
否
是否強制 SerpApi 即時重新擷取資料,即使已有快取。預設為 false
(允許使用快取)。設為 true
則不使用快取。快取有效期 1 小時,且快取搜尋免費
true
orfalse
api_key
字符串
是
指定 SerpApi 使用的私密金鑰。
-
響應
成功回應(HTTP 200)
響應機构
{
"search_metadata": {
"id": "55e12d9b-6dd4-4d4b-bb88-54e8cc6798da",
"json_endpoint": "https://webserp.abcproxy.com/files/0935edaf41fa9b00/55e12d9b-6dd4-4d4b-bb88-54e8cc6798da.json",
"created_at": "2025-04-02 16:37:45",
"google_news_url": "https://www.ebay.com/sch/i.html?_nkw=Coffee",
"raw_html_file": "https://webserp.abcproxy.com/files/0935edaf41fa9b00/55e12d9b-6dd4-4d4b-bb88-54e8cc6798da.html",
"xray_html_file": "https://webserp.abcproxy.com/files/0935edaf41fa9b00/55e12d9b-6dd4-4d4b-bb88-54e8cc6798da.xray",
"total_time_taken": "7.7340"
},
"search_parameters": {
"engine": "ebay",
"no_cache": true,
"api_key": "YOUR_API_KEY",
"_nkw": "Coffee"
},
"inline_results": [
{
"title": "Picked For You",
"items": [
{
"title": "Keurig Decaf Coffee Variety Pack, Keurig K-Cup Pods, 96 CountOpens in a new window or tab",
"link": "https://www.ebay.com/itm/314945798292?_skw=Coffee&itmmeta=01JQTTC9325881PMMMGG8R01T8&hash=item49543b8094:g:fZYAAOSwOhdlShvd&itmprp=enc%3AAQAKAAAA4FkggFvd1GGDu0w3yXCmi1c2MuHg0cS0xPKvVXwdBVRF9hQ9ASRDy4%2BSFIEbEEW8nhHwXamhTrVdMxpbJoCjz0YFW8IFF72kkW8%2BRkQhqWDLEBBe0ML9GP8rp3UkE4q4kcoddNekjXfwr2SN66TdFYjgASO5MW25XSgWucqq%2ByNUiloBKyg%2Fg%2FM%2FUdCfTHF2be2bcG7j%2BYyR5yCZby%2F03b4%2FtNqJQWeYTSoST4GrsnzpnSM0mOPebSjgo7h6lBdUngvCKbk4YfRpSbbvdDeTF5yAXoLpxL9%2BpmqSYlZ19%2FXB%7Ctkp%3ABFBM2JGx2r5l",
"price": [
{
"raw": "$39.99"
}
],
"thumbnail": "https://i.ebayimg.com/images/g/fZYAAOSwOhdlShvd/s-l500.webp",
"quantity_sold": "1,032 sold",
"seller": [
{
"username": "keurig"
}
]
},
{
"title": "Starbucks Premium Roast Ground Coffee - Medium Roast 12 bags 9LB Total (6/2025)Opens in a new window or tab",
"link": "https://www.ebay.com/itm/146350144403?_skw=Coffee&itmmeta=01JQTTC932P024NEP32ZT3TBBP&hash=item221325fb93:g:5ccAAOSwyDZnlB5M&itmprp=enc%3AAQAKAAAA4FkggFvd1GGDu0w3yXCmi1eOGt%2FYhl0obgVpXzNWNdtqT6Ec7a8S9npEyGsTVgdjMoQhryr8141DGpxWbZFWyWJXGuWvxCAsQFlFx1%2FaMLQkxA0IAvkD%2B%2FRYXqVUWMKDUAAYaizbV%2FCha%2BSszA3x2eoesg5n2aBHTUxAHgkcDWWUuVYHG%2B9KcXY878%2B0nFibZJuHdYFlGcNB44ZhVmM4KuVnZwsMSXzQE%2FDgomNWqeE6rdPbUyYT%2B3rsU%2BL7rlvE9%2BSgVju7ernYSi6VnWvwu%2Ft5TjMFCmnewMUwNgo5HzdI%7Ctkp%3ABFBM2JGx2r5l",
"price": [
{
"raw": "$62.99"
}
],
"thumbnail": "https://i.ebayimg.com/images/g/5ccAAOSwyDZnlB5M/s-l500.webp",
"quantity_sold": "26 watchers",
"seller": [
{
"username": "bigdeals"
}
]
},
"..."
]
}
],
"organic_results": [
{
"start_price": "$2.84",
"shipping": [
{
"raw": "Free delivery"
}
],
"thumbnail": "https://i.ebayimg.com/images/g/j-oAAeSwM1tn5~3H/s-l500.webp",
"promotion": "Save up to 13% when you buy more",
"link": "https://www.ebay.com/itm/356626588103?_skw=Coffee&var=625592313870&itmmeta=01JQTTC91H7ZB761NNWRWKMY2F&hash=item530899e1c7:g:j-oAAeSwM1tn5~3H&itmprp=enc%3AAQAKAAAA4FkggFvd1GGDu0w3yXCmi1dRCZEZByOZIOoeb06nolbgv28s7JAFhxZ2xqjO%2BQCoIwmyIpMuz1cFf1%2Bz92BEfdpt%2F60Ptl3hCNIHBnvMA9kLi3c2JIzbbn9o%2FwQCYf%2FdtLaSgGhMFZ%2BCIOkHan0m8VWBnfEuE1g%2Fq7JHuCo9Yd7yIIp%2Bt3qk8pDdYq552xx%2Fx3%2Fn0YJrQxXuatWq%2Bls2fPJP%2F6PQ1HJ0pVCYvAjL%2FL5RYB5HGwKUD1RYxCeRmGOKDNoKf%2B74eDzskhkBTwSMuO1apB3yUw2tlsWvFoZ0ZqpL%7Ctkp%3ABFBMmpGx2r5l",
"condition": "Brand New",
"end_price": "$18.99",
"seller": [
{
"reviews": "3245",
"positive_feedback_in_percentage": "99.2",
"username": "weicuihua"
}
],
"old_price": [
{
"raw": "$2.99",
"discount": "5% off"
}
],
"sponsored": true,
"title": "Mushroom Coffee-Organic Coffee Supplement - Boost Energy 22/38/80 ServingsOpens in a new window or tab"
},
{
"link": "https://www.ebay.com/itm/114300905102?_skw=Coffee&var=414553691594&itmmeta=01JQTTC91J6FMXRDCAG3R1FXE5&hash=item1a9cdd668e:g:HW8AAOSwPeNfC1kY&itmprp=enc%3AAQAKAAAA4FkggFvd1GGDu0w3yXCmi1dFIOlDi0d8aTtfdosGppisI2hOJYBdDVfps1YjB6S9F29TLhoZEDGRUrW0vttf5QrTv3%2B1fiYvEU8HU6HjjRlFkFN7dom33tBAuy1CPF3pKqlqBXuPX4rgKTTWfIUwVxUeuAHvqr00474YBjNqhboRWsc40yBFjyO8UTJu2UErnk9tFqiw6Qrjl5h1Otdl0oTR5muODI6C1LDPWJd9gJCQ4KQcUl2Eb8ehXa9QkdBW3LTXQbpzqoERWVC2ZV3Tm%2BJGDfPvqHaQ%2FPy2GS3CdsmS%7Ctkp%3ABFBMmpGx2r5l",
"condition": "You Can Buy A Cheaper Coffee But Never A Finer Coffee !Brand New",
"end_price": "$199.95",
"seller": [
{
"username": "bluemacawcoffeeroasters",
"reviews": "68924",
"positive_feedback_in_percentage": "99.9"
}
],
"sponsored": true,
"title": "100% JAMAICAN BLUE MOUNTAIN COFFEE BEANS MEDIUM ROASTED 2 TO 12 POUNDSOpens in a new window or tab",
"start_price": "$57.95",
"shipping": [
{
"raw": "+$3.99 delivery"
}
],
"thumbnail": "https://i.ebayimg.com/images/g/HW8AAOSwPeNfC1kY/s-l500.webp",
"quantity_sold": "71+ sold"
},
{
"sponsored": true,
"title": "NEW Organic Mushroom Coffee 60 Servings Per Pack Free Shipping US StockOpens in a new window or tab",
"link": "https://www.ebay.com/itm/356663743220?_skw=Coffee&var=625623720564&itmmeta=01JQTTC91KHQAV9Z568AAEABKX&hash=item530ad0d2f4:g:Z6MAAeSw8bpn0uXv&itmprp=enc%3AAQAKAAAA4FkggFvd1GGDu0w3yXCmi1dFGXNsOsqwNeg%2BEYYeU08rS2IUqtvF%2BK0AYN3cxohYWcisboVgPFuRwlS2AxPVhsraZQNZaftSibU3X6GWV0Juc0958ff4xdgKYUmb6E27tBihuL7ZL%2FA8OA8Rmc4retZhQhTbA%2BGy%2F00luBIXFB6BNf9R47WL78plFPDwdMXismvtZ2AOIVHLTihTbGIUXDRYvSbqGdAeLPDSQbe5A1Y9UrLd12R50ek5Fj3pwffPDxOGT4l%2FUtYcpIQ1kHpdDMYTo7gTT4%2F276HlU6%2F9nACa%7Ctkp%3ABFBMopGx2r5l",
"end_price": "$32.19",
"old_price": [
{
"raw": "$13.88",
"discount": "5% off"
}
],
"condition": "Brand New",
"start_price": "$13.19",
"shipping": [
{
"raw": "Free delivery"
}
],
"thumbnail": "https://i.ebayimg.com/images/g/Z6MAAeSw8bpn0uXv/s-l500.webp",
"promotion": "Save up to 13% when you buy more",
"seller": [
{
"username": "weicuihua",
"reviews": "3245",
"positive_feedback_in_percentage": "99.2"
}
]
}
"..."
],
"categories": [
{
"name": "All"
},
{
"name": "Kitchen, Dining & Bar",
"id": "20625"
},
{
"id": "14308",
"name": "Food & Beverages"
},
"..."
]
}
響應欄位
search_metadata
對象
搜尋的元資訊,如 ID 與時間
search_parameters
對象
實際使用的查詢參數
inline_results
對象數組
內嵌結果
organic_results
對象數組
自然搜尋結果
categories
對象數組
分類資訊
錯誤回應
常見錯誤碼與說明
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"
}
最后更新于