eBay Product Research

eBay Product Research: search API

eBay Product Research: search API.

MCP tool name

nexscope_data_ebay_search

MCP endpoint

https://api.nexscope.ai/mcp

JSON-RPC method

tools/call

Authentication

Use OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope. API keys remain supported as a compatibility option.

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx

If authentication fails, ask the user to open API Access and copy a valid key.

Call this MCP tool

Initialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/mcp, then use tools/call.

{
  "jsonrpc": "2.0",
  "id": "data-ebay-search-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_data_ebay_search",
    "arguments": {
      "ebayDomain": "ebay.com",
      "keyword": "wireless earbuds",
      "orderBy": "12",
      "pageSize": 50
    }
  }
}

MCP 2025-11-25 · Streamable HTTP

Progress is delivered on the original POST SSE response. GET SSE carries notifications; reconnecting must query existing asynchronous work rather than submit again.

Arguments

Name	Type	Required	Description
`keyword`	`string`	optional	Search keywords, maximum 1024 characters Example: {}
`ebayDomain`	`string`	optional	eBay site domain name. Optional values: `ebay.com` (United States), `ebay.co.uk` (UK), `ebay.de` (Germany), `ebay.fr` (France), `ebay.it` (Italy), `ebay.es` (Spain), `ebay.ca` (Canada), `ebay.com.au` (Australia) ), `ebay.nl` (Netherlands), `ebay.at` (Austria), `ebay.ch` (Switzerland), `ebay.pl` (Poland), `ebay.ie` (Ireland), `ebay.com.hk` (Hong Kong, China), `ebay.com.my` (Malaysia), `ebay.com.sg` (Singapore) Example: {}
`page`	`integer`	optional	Page number, used for pagination Example: 1
`pageSize`	`integer`	optional	The maximum number of results returned per page. Optional values: `25`, `50`, `100`, `200` Example: 50
`orderBy`	`string`	optional	Sort by. Optional values: `1` (soon to end), `2` (lowest price), `3` (highest price), `7` (closest), `10` (latest on the shelves), `12` (best match), `15` (lowest price + shipping fee), `16` (highest price + shipping fee), `18` (new product first), `19` (second-hand priority) Example: 12
`priceMin`	`number`	optional	Lowest price filter Example: {}
`priceMax`	`number`	optional	Highest price filter Example: {}
`itemCondition`	`string`	optional	Product status code, multiple separated by `\\|`. Optional values: `1000` (new), `1500` (new other), `1750` (new with defects), `2000` (official refurbished), `2010` (excellent refurbished), `2020` (Good Refurbished), `2030` (Generally Refurbished), `2500` (Seller Refurbished), `2750` (Almost New), `3000` (Second Hand/Used), `7000` (Accessory or Not Working) Example: {}
`buyingFormat`	`string`	optional	Purchase format. Optional values: `Auction` (auction), `BIN` (fixed price), `BO` (best offer) Example: {}
`showOnly`	`string`	optional	Filter conditions, multiple values separated by commas. Optional values: `Complete` (Ended), `Sold` (Sold), `FR` (Free Returns), `RPA` (Returns Accepted), `AS` (Authorized Seller), `Savings` (discount), `SaleItems` (promotional items), `Lots` (bulk), `Charity` (charity), `AV`, `FS` (free shipping), `LPickup` (self-pickup) Example: {}
`location`	`integer`	optional	The country/region code where the product is located, for example: `1` (United States), `2` (Canada), `3` (UK), `45` (China), `77` (Germany) Example: {}
`prefLoc`	`string`	optional	Preferred location range. Optional values: `1` (national), `2` (regional), `3` (global) Example: {}
`zipCode`	`string`	optional	ZIP or postal code to filter products for delivery by area Example: {}
`categoryId`	`integer`	optional	eBay category ID, used to search for specified categories Example: {}
`noCache`	`boolean`	optional	Whether to disable caching Example: false

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Description
`total`	`integer`	optional	Total number of matching results Example: {}
`products`	`array`	optional	Product list array (see product fields below for details) Example: {}
`columns`	`array`	optional	Rendered column definitions Example: {}
`type`	`string`	optional	Rendering style identifier Example: {}
`costToken`	`integer`	optional	Consume token Example: {}
`productId`	`string`	optional	eBay item ID Example: {}
`title`	`string`	optional	Product title Example: {}
`subtitle`	`string`	optional	Product subtitle Example: {}
`price`	`number`	optional	Current price/transaction price Example: {}
`minPrice`	`number`	optional	Starting value of the price range (applicable to products of multiple specifications) Example: {}
`maxPrice`	`number`	optional	The end value of the price range (applicable to multi-specification products) Example: {}
`oldPrice`	`number`	optional	Original price before discount Example: {}
`currency`	`string`	optional	Currency units such as USD, GBP, EUR Example: {}
`condition`	`string`	optional	Product status description Example: {}
`link`	`string`	optional	eBay product detail page link Example: {}
`imageUrl`	`string`	optional	Product thumbnail URL Example: {}
`shipping`	`string`	optional	Shipping information Example: {}
`location`	`string`	optional	Product location Example: {}
`sellerName`	`string`	optional	Seller name Example: {}
`sellerReviews`	`integer`	optional	Number of seller reviews Example: {}
`positiveFeedbackInPercentage`	`number`	optional	Seller’s positive rating Example: {}
`salesQuantity`	`integer`	optional	Quantity sold Example: {}
`bidsCount`	`integer`	optional	Bid quantity (auction items) Example: {}
`returns`	`string`	optional	Return information Example: {}
`promotion`	`string`	optional	Promotional information Example: {}
`sponsored`	`boolean`	optional	Is it a sponsored/promoted product? Example: {}
`sourceType`	`string`	optional	Source platform identification (`ebay`) Example: {}

Examples

Example arguments

{
  "ebayDomain": "ebay.com",
  "keyword": "wireless earbuds",
  "orderBy": "12",
  "pageSize": 50
}

Example structuredContent

{
  "code": 0,
  "cost": "-1",
  "data": {},
  "msg": null,
  "time": "2026-01-01 00:00:00",
  "traceId": null,
  "ts": "0"
}