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

Request parameters

Name	Type	Required	Description
`marketplace`	`string`	optional	Amazon site code, default US. Options: US, UK, DE, FR, JP, CA, IT, ES, MX, AU, TR, IN Example: US
`keyword`	`string`	optional	Search keyword. Translate to the corresponding country's language whenever possible, e.g. use English keywords for the US, German keywords for Germany, etc. Example: phone case
`asinList`	`string`	optional	ASINs, multiple ASINs comma-separated, max 40. Format: ^[A-Z0-9]+(,[A-Z0-9]+){0,39}$ Example: B072MQ5BRX
`sellerName`	`string`	optional	Seller name filter

Code example

{
  "size": 50,
  "matchType": 1,
  "asinList": "B072MQ5BRX",
  "page": 1,
  "keyword": "phone case",
  "marketplace": "US"
}

Response example

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

{
  "data": {
    "total": 1,
    "columns": [],
    "products": [
      {
        "asin": "B072MQ5BRX",
        "price": 1,
        "primePrice": 1,
        "averagePrice": 1,
        "monthlySalesUnits": 1,
        "monthlySalesRevenue": 1,
        "monthlySalesUnitsGrowthRate": 1,
        "bsr": 1,
        "bsrGrowthRate": 1,
        "bsrGrowthCount": 1,
        "rating": 1,
        "ratings": 1,
        "ratingsGrowth": 1,
        "ratingsRate": 1,
        "brandUrl": "https://example.com/image.jpg",
        "sellerId": "example-id",
        "sellerNum": 1,
        "availableDate": "2026-01-01",
        "availableDateString": "2026-01-01",
        "profit": 1,
        "fba": 1,
        "deliveryPrice": 1,
        "imageUrl": "https://example.com/image.jpg",
        "variationNum": 1,
        "variant30DayUnits": 1,
        "variant30DayRevenue": 1,
        "variant30DayUpdatedAt": "2026-01-01",
        "amzUnitDateString": "2026-01-01",
        "listingQualityScore": 1,
        "nodeId": 1,
        "keyword": "phone case",
        "badge": {},
        "subcategories": []
      }
    ],
    "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 result count

Example: 1

data.sourceType

string

optional

Source type (e.g. amazon)

Example: null

data.type

string

optional

Render style

Example: null

data.columns

array

optional

Render column definitions

Example: []

data.products

array

optional

Competitor list (see below)

Example: []

data.products[]

object

required

Item in data products.

data.products[].nodeLabel

string

optional

Category name echo

Example: null

data.products[].asin

string

optional

Product ASIN

Example: B072MQ5BRX

data.products[].title

string

optional

Product title

Example: null

data.products[].price

number

optional

Current price

Example: 1

data.products[].primePrice

number

optional

Prime price

Example: 1

data.products[].averagePrice

number

optional

Average price

Example: 1

data.products[].currency

string

optional

Currency

Example: null

data.products[].monthlySalesUnits

integer

optional

Monthly sales volume (units)

Example: 1

data.products[].monthlySalesRevenue

number

optional

Monthly sales revenue

Example: 1

data.products[].monthlySalesUnitsGrowthRate

number

optional

Monthly sales volume growth rate

Example: 1

data.products[].bsr

integer

optional

BSR rank

Example: 1

data.products[].bsrGrowthRate

number

optional

BSR growth rate

Example: 1

data.products[].bsrGrowthCount

integer

optional

BSR growth count

Example: 1

data.products[].rating

number

optional

Rating

Example: 1

data.products[].ratings

integer

optional

Review count

Example: 1

data.products[].ratingsGrowth

integer

optional

Monthly new review count

Example: 1

data.products[].ratingsRate

number

optional

Review rate

Example: 1

data.products[].brand

string

optional

Brand

Example: null

data.products[].brandUrl

string

optional

Brand URL

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

data.products[].sellerName

string

optional

BuyBox seller name

Example: null

data.products[].sellerId

string

optional

BuyBox seller ID

Example: example-id

data.products[].sellerNation

string

optional

BuyBox seller nationality

Example: null

data.products[].sellerNum

integer

optional

Number of sellers

Example: 1

data.products[].fulfillment

string

optional

Fulfillment method: AMZ, FBA, FBM

Example: null

data.products[].availableDate

string

optional

Listing time (date format)

Example: 2026-01-01

data.products[].availableDateString

string

optional

Listing date (string format)

Example: 2026-01-01

data.products[].profit

number

optional

Gross margin

Example: 1

data.products[].fba

number

optional

FBA shipping fee

Example: 1

data.products[].deliveryPrice

number

optional

Seller shipping fee

Example: 1

data.products[].imageUrl

string

optional

Product image URL

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

data.products[].parent

string

optional

Parent ASIN

Example: null

data.products[].variationNum

integer

optional

Number of variations

Example: 1

data.products[].variant30DayUnits

integer

optional

Variant monthly sales (units)

Example: 1

data.products[].variant30DayRevenue

number

optional

Variant monthly sales revenue

Example: 1

data.products[].variant30DayUpdatedAt

string

optional

Variant data update time (timestamp)

Example: 2026-01-01

data.products[].amzUnitDateString

string

optional

Variant sales update date

Example: 2026-01-01

data.products[].listingQualityScore

number

optional

Listing quality score

Example: 1

data.products[].nodeLabelPath

string

optional

Category path

Example: null

data.products[].nodeIdPath

string

optional

Node ID path

Example: null

data.products[].nodeId

integer

optional

Node ID

Example: 1

data.products[].dimension

string

optional

Product dimensions

Example: null

data.products[].dimensionsType

string

optional

Dimension type

Example: null

data.products[].weight

string

optional

Product weight

Example: null

data.products[].packageDimensions

string

optional

Package dimensions

Example: null

data.products[].packageDimensionType

string

optional

Package dimension type

Example: null

data.products[].packageWeight

string

optional

Package weight

Example: null

data.products[].sku

string

optional

SKU

Example: null

data.products[].keyword

string

optional

Matching keyword (if searched by keyword, displays the corresponding keyword)

Example: phone case

data.products[].dataSnapshotMonth

string

optional

Data query month

Example: null

data.products[].sourceTool

string

optional

Source tool

Example: null

data.products[].sourceType

string

optional

Source type

Example: null

data.products[].badgeBestSeller

string

optional

Best Seller badge (Y/N)

Example: null

data.products[].badgeAmazonChoice

string

optional

Amazon's Choice badge (Y/N)

Example: null

data.products[].badgeNewRelease

string

optional

New Release badge (Y/N)

Example: null

data.products[].badgeEbc

string

optional

A+ page (Y/N)

Example: null

data.products[].badgeVideo

string

optional

Video introduction (Y/N)

Example: null

data.products[].badge

object

optional

Badge detail object, containing: bestSeller, amazonChoice, newRelease, ebc, video (all Y/N strings)

Example: {}

data.products[].subcategories

array

optional

Subcategory rankings, each entry containing code (category code), rank (rank), label (name)

Example: []

data.costToken

integer

optional

Tokens consumed

Example: 1

data.title

string

optional

Provider-specific response title.

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 Competitor Lookup

What this API does

Amazon Competitor Lookup

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