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"

import requests

params = {
    "engine": "ebay",
    "_nkw": "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: "ebay",
  _nkw: "Coffee",
  no_cache: "false",
  api_key: "YOUR_API_KEY"
};

axios.get("https://serpapi.abcproxy.com/search", { params })
  .then(response => console.log(response.data));

GET /search?engine=ebay&q=Coffee&no_cache=false&api_key=YOUR_API_KEY HTTP/1.1
Host: serpapi.abcproxy.com

<?php
$client = new \GuzzleHttp\Client();
$response = $client->get('https://serpapi.abcproxy.com/search', [
    'query' => [
        'engine' => 'ebay',
        '_nkw' => '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", "ebay")
    q.Add("_nkw", "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"] = "ebay";
        query["_nkw"] = "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=ebay" +
            "&_nkw=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 參數說明

搜尋參數

參數名稱

類型

必填項

說明

範例

_nkw

字符串

是

搜尋關鍵字，與 eBay 搜尋欄中使用的字串相同。如果指定 category_id，此參數可為選填。

Coffee

地區與語言設定

參數名稱

類型

必填項

說明

範例

ebay_domain

字符串

否

此參數用來指定要使用的 eBay 網域，預設為 ebay.com。完整支援的網域請參見 Ebay 網域清單。

us

_salic

字符串

否

此參數用來依據國家設定地理位置。完整支援的國家選項請參見 Ebay 地區選項。

en

分頁參數

參數名稱

類型

必填項

說明

範例

_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

_sop

字符串

否

定義排序方式，預設為「Best Match」。完整排序選項請參考 Ebay sort options。

_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 小時，且快取搜尋免費

trueorfalse

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

對象數組

分類資訊

錯誤回應

常見錯誤碼與說明

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

最后更新于17天前