eBay Product Research

eBay Search

Search and browse product listings across multiple international eBay sites. Call the eBay Search API via REST or MCP from 21 credits per call.

MCP tool name

nexscope_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": "ebay-search-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_ebay_search",
    "arguments": {
      "keyword": "phone case",
      "page": 1,
      "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 keyword, max 1024 characters Example: phone case
`ebayDomain`	`string`	optional	eBay site domain, default ebay.com. Options: ebay.com (United States), ebay.co.uk (United Kingdom), 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 for pagination, default 1 Example: 1
`pageSize`	`integer`	optional	Maximum results per page, default 50. Options: 25, 50, 100, 200 Example: 50
`orderBy`	`string`	optional	Sort order, default 12 (Best Match). Options: 1 (Ending soonest), 2 (Price lowest), 3 (Price highest), 7 (Distance nearest), 10 (Newly listed), 12 (Best Match), 15 (Price + shipping lowest), 16 (Price + shipping highest), 18 (New first), 19 (Used first) Example: 12
`priceMin`	`number`	optional	Minimum price filter Example: 1
`priceMax`	`number`	optional	Maximum price filter Example: 1
`itemCondition`	`string`	optional	Item condition codes separated by \|. Options: 1000, 1500, 1750, 2000, 2010, 2020, 2030, 2500, 2750, 3000, 7000 Example: {}
`buyingFormat`	`string`	optional	Buying format. Options: Auction, BIN (Buy It Now), BO (Best Offer) Example: {}
`showOnly`	`string`	optional	Filter conditions, comma-separated for multiple values. Options: Complete (Ended), Sold (Sold), FR (Free returns), RPA (Returns accepted), AS (Authorized seller), Savings (Discounts), SaleItems (Sale items), Lots (Lots), Charity (Charity), AV, FS (Free shipping), LPickup (Local pickup) Example: {}
`location`	`integer`	optional	Country/region code of item location (e.g., 1=United States, 2=Canada, 3=United Kingdom, 45=China, 77=Germany) Example: 1
`prefLoc`	`string`	optional	Preferred location scope. Options: 1 (Domestic), 2 (Regional), 3 (Worldwide) Example: {}
`zipCode`	`string`	optional	ZIP or postal code for filtering shippable items by region Example: {}
`categoryId`	`integer`	optional	eBay category ID for category-specific search Example: 1
`noCache`	`boolean`	optional	Whether to bypass cache, default false 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

{
  "keyword": "phone case",
  "page": 1,
  "pageSize": 50
}

Example structuredContent

{}