POSThttps://api.nexscope.ai/api/skill-api/v1/skills/ebay-search/run

Run this API

Send a JSON request to execute this API and receive the documented response payload.

Endpoint

Method	`POST`
Path	`https://api.nexscope.ai/api/skill-api/v1/skills/ebay-search/run`
Auth	`Bearer API key`
Content-Type	`application/json`

Request parameters

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)
`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

Code example

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

Response example

Platform response envelope. code 0 indicates success or acceptance; data contains the business result.

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

Response fields

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`

Responses

Code	Description
200	HTTP request completed. Check JSON code; only 0 indicates business success or acceptance.
400	Request JSON or required API parameters are invalid.
401	API key is missing, invalid, or cannot be matched to a user.
5xx	API execution or upstream service failed.

Data source, freshness, and limitations

Source, freshness, coverage, rate limits, and estimation notes are not specified in this API definition unless they appear in the request or response field documentation above. Do not assume official marketplace data or real-time freshness when it is not explicitly documented.

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

eBay product ID

Example: example-id

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.

eBay Search

What this API does

eBay Search

What this API does

Authentication

Run an API

Example request

Check the response

HTTP status codes

Run this API

Endpoint

Request parameters

Code example

Response example

Response fields

Responses

Data source, freshness, and limitations

MCP

Call a tool

Legacy MCP v1

Online test

Try it

Any of option 1

Any of option 2