eBay
eBay Search
Search and browse product listings across multiple eBay international sites.
MCP tool name
nexscope_ebay_searchMCP endpoint
https://api.nexscope.ai/api/skill-api/v2/mcpJSON-RPC method
tools/calleBay
Search and browse product listings across multiple eBay international sites.
nexscope_ebay_searchhttps://api.nexscope.ai/api/skill-api/v2/mcptools/callUse OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope for standard remote clients. API keys remain supported as a compatibility option while v1 integrations migrate.
Authorization: Bearer nk-xxxxxxxxxxxxxxxxxIf authentication is missing or invalid, ask the user to open API Access and copy a valid key before calling this tool.
Initialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/api/skill-api/v2/mcp, then use tools/call with the MCP tool name below. The arguments object should match the table on this page.
{
"jsonrpc": "2.0",
"id": "ebay-search-1",
"method": "tools/call",
"params": {
"name": "nexscope_ebay_search",
"arguments": {
"pageSize": 50,
"page": 1,
"keyword": "phone case"
}
}
}MCP 2025-11-25 · Streamable HTTPhttps://www.nexscope.ai/mcp-map/ebay-searchProgress is delivered on the original POST SSE response when the client supplies a progress token and the tool has real execution stages. GET SSE carries server notifications such as tool-list changes. Creating an asynchronous task or calling an external provider may consume credits; reconnecting must query the existing task instead of submitting it again.
| 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 |
Treat structuredContent as the programmatic API response payload.
| Name | Type | Required | Description |
|---|---|---|---|
data | any | required | Data value used by this API operation. |
code | integer | required | 0 means accepted or successful; nonzero is a platform error. |
msg | string | null | required | Msg value used by this API operation. |
ts | string | required | Epoch milliseconds. |
time | string | required | Server local time: yyyy-MM-dd HH:mm:ss. |
cost | string | required | Elapsed milliseconds, never credits; -1 outside web requests. |
traceId | string | null | required | Trace id value used by this API operation. |
| Name | Type | Required | Description |
|---|---|---|---|
data | object | required | Data value used by this API operation. |
data.total | integer | optional | Total matching results Example: 1 |
data.products | array | optional | Product list array (see product fields below) Example: [] |
data.products[] | object | required | Item in data products. |
data.products[].productId | string | optional |
{
"pageSize": 50,
"page": 1,
"keyword": "phone case"
}{
"data": {
"total": 1,
"products": [
{
"productId": "example-id",
"price": 1,
"minPrice": 1,
"maxPrice": 1,
"oldPrice": 1,
"imageUrl": "https://example.com/image.jpg",
"sellerReviews": 1,
"positiveFeedbackInPercentage": 1,
"salesQuantity": 1,
"bidsCount": 1,
"sponsored": false
}
],
"columns": [],
"costToken": 1
},
"code": 0,
"msg": null,
"ts": "0",
"time": "2026-01-01 00:00:00",
"cost": "-1",
"traceId": null
}data.products[].title | string | optional | Product title Example: null |
data.products[].subtitle | string | optional | Product subtitle Example: null |
data.products[].price | number | optional | Current price / transaction price Example: 1 |
data.products[].minPrice | number | optional | Price range start value (for multi-SKU items) Example: 1 |
data.products[].maxPrice | number | optional | Price range end value (for multi-SKU items) Example: 1 |
data.products[].oldPrice | number | optional | Original price before discount Example: 1 |
data.products[].currency | string | optional | Currency unit (e.g., USD, GBP, EUR) Example: null |
data.products[].condition | string | optional | Item condition description Example: null |
data.products[].link | string | optional | eBay product detail page link Example: null |
data.products[].imageUrl | string | optional | Product thumbnail URL Example: https://example.com/image.jpg |
data.products[].shipping | string | optional | Shipping information Example: null |
data.products[].location | string | optional | Item location Example: null |
data.products[].sellerName | string | optional | Seller name Example: null |
data.products[].sellerReviews | integer | optional | Seller feedback count Example: 1 |
data.products[].positiveFeedbackInPercentage | number | optional | Seller positive feedback percentage Example: 1 |
data.products[].salesQuantity | integer | optional | Quantity sold Example: 1 |
data.products[].bidsCount | integer | optional | Bid count (for auction items) Example: 1 |
data.products[].returns | string | optional | Return information Example: null |
data.products[].promotion | string | optional | Promotion information Example: null |
data.products[].sponsored | boolean | optional | Whether sponsored/promoted item Example: false |
data.products[].sourceType | string | optional | Source platform identifier (ebay) Example: null |
data.products[].sourceTool | string | optional | Source tool identifier Example: null |
data.columns | array | optional | Rendered column definitions Example: [] |
data.type | string | optional | Render style identifier Example: null |
data.costToken | integer | optional | Token consumption Example: 1 |
data.title | string | optional | Provider-specific response title. Example: null |
data.sourceType | string | optional | Provider-specific source platform type. Example: null |
data.sourceTool | string | optional | Provider-specific source tool name. Example: null |
data.costTime | integer | optional | Execution time reported by the upstream provider. Example: null |
data.page | integer | optional | Current page returned by the upstream provider. Example: null |
data.pageSize | integer | optional | Page size returned by the upstream provider. Example: null |
data.pageItemCount | integer | optional | Item count on the current page returned by the upstream provider. Example: null |
data.totalPage | integer | optional | Total page count returned by the upstream provider. Example: null |
data.dataSnapshotMonth | string | optional | Data snapshot month returned by the upstream provider. Example: null |
| Name | Type | Required | Description |
|---|---|---|---|
data | null | required | Data value used by this API operation. |