POSThttps://api.nexscope.ai/api/skill-api/v1/skills/amazon-product-database/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/amazon-product-database/run`
Auth	`Bearer API key`
Content-Type	`application/json`

Request parameters

Name	Type	Required	Description
`marketplace`	`string`	required	Target marketplace code. Options: us, uk, de, in, ca, fr, it, es, mx, jp Example: us
`includeKeywords`	`string`	optional	Keywords to include in title/ASIN, comma-separated, up to 100 items, max 50 chars each Example: phone case
`excludeKeywords`	`string`	optional	Keywords to exclude from title/ASIN, comma-separated, up to 100 items, max 50 chars each Example: phone case
`categories`	`string`	optional	Primary category names, comma-separated, must match the standard category names for the corresponding site. US site examples: Appliances, Arts Crafts & Sewing, Automotive, Baby, Beauty & Personal Care, Books, CDs & Vinyl, Cell Phones & Accessories, Clothing Shoes & Jewelry, Collectibles & Fine Art, Computers, Digital Music, Electronics, Garden & Outdoor, Grocery & Gourmet Food, Handmade, Health Household & Baby Care, Home & Kitchen, Industrial & Scientific, Kindle Store, Kitchen & Dining, Movies & TV, Musical Instruments, Office Products, Pet Supplies, Sports & Outdoors, Tools & Home Improvement, Toys & Games, Video Games, etc. Other sites (uk, de, fr, it, es, mx, jp, ca, in) have their own localized category names

Code example

{
  "needCount": 10,
  "includeKeywords": "phone case",
  "marketplace": "us",
  "sort": "-sales"
}

Response example

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

{
  "data": {
    "costToken": 1,
    "productDatabaseList": [
      {
        "id": "example-id",
        "price": 1,
        "approximate30DayUnitsSold": 1,
        "approximate30DayRevenue": 1,
        "productRank": 1,
        "reviews": 1,
        "rating": 1,
        "listingQualityScore": 1,
        "numberOfSellers": 1,
        "imageUrl": "https://example.com/image.jpg",
        "dateFirstAvailable": "2026-01-01",
        "weightValue": 1,
        "lengthValue": 1,
        "widthValue": 1,
        "heightValue": 1,
        "parentAsin": "B072MQ5BRX",
        "isParent": false,
        "isVariant": false,
        "isStandalone": false,
        "isAvailable": false,
        "buyBoxOwnerSellerId": "example-id",
        "updatedAt": "2026-01-01",
        "feeBreakdown": {},
        "subcategoryRanks": [],
        "variants": [],
        "upcList": [],
        "eanList": [],
        "isbnList": [],
        "gtinList": [],
        "dateFirstAvailableIsEstimated": false
      }
    ]
  },
  "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.costToken

integer

optional

Token consumption

Example: 1

data.productDatabaseList

array

optional

Product data list

Example: []

data.productDatabaseList[]

object

required

Item in data productDatabaseList.

data.productDatabaseList[].id

string

optional

Product unique identifier

Example: example-id

data.productDatabaseList[].title

string

optional

Product title

Example: null

data.productDatabaseList[].brand

string

optional

Brand name

Example: null

data.productDatabaseList[].category

string

optional

Primary category

Example: null

data.productDatabaseList[].breadcrumbPath

string

optional

Full category path

Example: null

data.productDatabaseList[].price

number

optional

Current selling price (USD)

Example: 1

data.productDatabaseList[].approximate30DayUnitsSold

integer

optional

Estimated units sold in last 30 days

Example: 1

data.productDatabaseList[].approximate30DayRevenue

number

optional

Estimated revenue in last 30 days (USD)

Example: 1

data.productDatabaseList[].productRank

integer

optional

BSR ranking

Example: 1

data.productDatabaseList[].reviews

integer

optional

Total number of reviews

Example: 1

data.productDatabaseList[].rating

number

optional

Average rating (1.0-5.0)

Example: 1

data.productDatabaseList[].listingQualityScore

integer

optional

Listing quality score (LQS, 1-10)

Example: 1

data.productDatabaseList[].numberOfSellers

integer

optional

Number of active sellers

Example: 1

data.productDatabaseList[].sellerType

string

optional

Seller type (amz/fba/fbm)

Example: null

data.productDatabaseList[].imageUrl

string

optional

Product main image URL

Example: https://example.com/image.jpg

data.productDatabaseList[].dateFirstAvailable

string

optional

Date first listed

Example: 2026-01-01

data.productDatabaseList[].weightValue

number

optional

Product weight

Example: 1

data.productDatabaseList[].weightUnit

string

optional

Weight unit

Example: null

data.productDatabaseList[].lengthValue

number

optional

Length

Example: 1

data.productDatabaseList[].widthValue

number

optional

Width

Example: 1

data.productDatabaseList[].heightValue

number

optional

Height

Example: 1

data.productDatabaseList[].dimensionsUnit

string

optional

Dimensions unit

Example: null

data.productDatabaseList[].parentAsin

string

optional

Parent ASIN

Example: B072MQ5BRX

data.productDatabaseList[].isParent

boolean

optional

Whether it is a parent listing

Example: false

data.productDatabaseList[].isVariant

boolean

optional

Whether it is a variant

Example: false

data.productDatabaseList[].isStandalone

boolean

optional

Whether it is a standalone product

Example: false

data.productDatabaseList[].isAvailable

boolean

optional

Whether it is available for purchase

Example: false

data.productDatabaseList[].buyBoxOwner

string

optional

Buy Box owner seller name

Example: null

data.productDatabaseList[].buyBoxOwnerSellerId

string

optional

Buy Box owner seller ID

Example: example-id

data.productDatabaseList[].updatedAt

string

optional

Data update time

Example: 2026-01-01

data.productDatabaseList[].feeBreakdown

object

optional

Fee details: fbaFee (FBA fee), referralFee (referral fee), variableClosingFee (variable closing fee), totalFees (total fees)

Example: {}

data.productDatabaseList[].subcategoryRanks

array

optional

Subcategory BSR ranking list, each item contains subcategory, rank, id

Example: []

data.productDatabaseList[].type

string

optional

Resource type

Example: null

data.productDatabaseList[].variants

array

optional

Variant list

Example: []

data.productDatabaseList[].upcList

array

optional

UPC code list

Example: []

data.productDatabaseList[].eanList

array

optional

EAN code list

Example: []

data.productDatabaseList[].isbnList

array

optional

ISBN code list

Example: []

data.productDatabaseList[].gtinList

array

optional

GTIN code list

Example: []

data.productDatabaseList[].dateFirstAvailableIsEstimated

boolean

optional

Whether the listing date is estimated

Example: false

data.type

string

optional

Provider-specific render or payload type.

Example: null

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.

Amazon Product Database

What this API does

Amazon Product Database

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

Related APIs

Any of option 1

Any of option 2