Amazon Marketplace Intelligence

Amazon Competitor Lookup

Use Nexscope data to find and analyze competitors on Amazon, covering 12 marketplaces, with product metrics including sales, BSR, pricing, ratings, and growth trends. Trigger when the user mentions competitor lookup, competitor analysis, ASIN reverse lookup, competitive product research, finding similar products, market competitor discovery, product benchmarking, competitor sales estimation, analyzing competitor listings, competitor analysis, ASIN reverse lookup, competitor sales, competitor research, Nexscope, market competitor discovery, competitor trends. Even if the user does not explicitly mention "Nexscope" or "competitor lookup", if their need involves discovering and analyzing Amazon competitors by ASIN, keyword, seller name, brand, or category, this skill should also be triggered.

post/api/skill-api/v1/skills/amazon-competitor-lookup/run

Request

  • Base URL: https://api.nexscope.ai
  • URL: https://api.nexscope.ai/api/skill-api/v1/skills/amazon-competitor-lookup/run
  • Auth: HTTP bearer

Headers

X-Nexscope-Http-Status'legacy' | 'semantic'

Use semantic for HTTP error statuses on run and task-result requests. Without this header v1 retains legacy status behavior. The JSON envelope is unchanged; code 0 means success or acceptance, not asynchronous completion.

Request body

marketplacestring

Amazon site code, default US. Options: US, UK, DE, FR, JP, CA, IT, ES, MX, AU, TR, IN

keywordstring

Search keyword. Translate to the corresponding country's language whenever possible, e.g. use English keywords for the US, German keywords for Germany, etc.

asinListstring

ASINs, multiple ASINs comma-separated, max 40. Format: ^[A-Z0-9]+(,[A-Z0-9]+){0,39}$

sellerNamestring

Seller name filter

brandstring

Brand name filter

nodeLabelstring

Amazon category name, supports multi-level category names, levels separated by colon :, e.g. Electronics:Headphones

nodeIdPathstring

Amazon category ID path

matchTypeinteger

Match type. 1 = phrase match (default), 2 = fuzzy match, 3 = exact match

showVariationstring

Whether to query variants. Y = yes, N = no (default)

dataSnapshotMonthstring

Amazon product data snapshot month. Default nearly (queries last 30 days real-time data). Use yyyyMM format to query historical snapshots (e.g. 202412 for December 2024). Only supports existing historical snapshots, future dates are not supported. Recommended for seasonal analysis to query the same period last year's snapshot for comparison

pageinteger

Page number, starting from 1 (default 1)

sizeinteger

Results per page, returns 10-100 records (default 50)

orderobject

Sort configuration (see below)

Example request

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

Response

Successful response.

codeinteger required

0 means accepted or successful; nonzero is a platform error.

msgstring nullable required
tsstring required

Epoch milliseconds.

timestring required

Server local time: yyyy-MM-dd HH:mm:ss.

coststring required

Elapsed milliseconds, never credits; -1 outside web requests.

traceIdstring nullable required

Example response

{
  "data": {
    "total": 1,
    "products": [],
    "costToken": 1
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.