eBay Product Search

eBay Product Search is used to fetch eBay product search results by keyword.

Search eBay products by keyword
Support region-based requests
Support fetching multiple pages starting from a specific page
Return product results, category data, and refinement options

Use XCrawl to Fetch eBay Product Search Results

Usage

curl -s -X POST 'https://run.xcrawl.com/v1/data' \
  -H 'Authorization: Bearer $XCRAWL_API_KEY'\
  -H 'Content-Type: application/json' \
  -d '{
    "engine": "ebay_search",
    "location": "US",
    "keyword_list": ["coffee maker"],
    "start_page": 1,
    "pages": 1
  }'

Request parameter notes:

engine must be ebay_search
location specifies the target region
keyword_list accepts one or more search keywords
start_page and pages control the page range to fetch

Response Example

{
  "result": [
    {
      "url": "https://www.ebay.com/sch/i.html?_nkw=Coffee+Maker",
      "page": 1,
      "query": "Coffee Maker",
      "results": [
        {
          "title": "Keurig K-Classic Coffee Maker",
          "price": "59.99",
          "currency": "USD",
          "url": "https://www.ebay.com/itm/xxxxxxxxxxxx",
          "image": "https://i.ebayimg.com/images/..."
        }
      ],
      "categories": [
        {
          "name": "Home & Garden",
          "link": "https://www.ebay.com/sch/11700/i.html?_nkw=Coffee+Maker"
        }
      ],
      "refinements": {
        "Brand": [
          {
            "name": "Keurig",
            "link": "https://www.ebay.com/sch/i.html?_nkw=Coffee+Maker&Brand=Keurig"
          }
        ]
      }
    }
  ]
}

Parameters

Required Parameters

Parameter	Type	Description
`location`	`string`	Specifies the target region.
`keyword_list`	`array`	Accepts one or more search keywords.
`start_page`	`number`	Specifies the page number to start from.
`pages`	`number`	Specifies how many pages to fetch.

Parameter Notes

location defaults to US
location supports multiple region values such as US, HK, CA, GB, and JP
keyword_list defaults to an empty array and should contain search keywords
start_page defaults to 1
pages defaults to 1

Response Fields

Field	Type	Description
`url`	`string`	Fetched eBay search page URL.
`page`	`number`	Current page number.
`query`	`string`	Current search keyword.
`results`	`array`	Product search result list.
`categories`	`array`	Category navigation list.
`refinements`	`object`	Search refinement options.

Result Item Fields

Items in results[] typically include the product title, price, currency, URL, image, and other card-level product information.

Category Fields

Each item in categories[] typically includes:

Field	Type	Description
`name`	`string`	Category name.
`link`	`string`	Category URL.

refinements returns available filters for the current search result page, such as brand, price range, condition, shipping options, and buying format. Each option usually includes a display name and a corresponding URL.

SERP

Engines

Data

APIs