openapi: 3.2.0 info: title: Nexscope Ecommerce Data and Creative Amazon Marketplace… version: 2026-08-28-public-catalog-v1 description: Nexscope APIs provide ecommerce marketplace intelligence and creative generation capabilities through REST and MCP. Authentication uses a Nexscope API key. Pricing is credit-based and actual usage varies by endpoint and workload; current estimates are shown in the Nexscope account. termsOfService: https://www.nexscope.ai/terms contact: name: Nexscope Support email: service@nexscope.ai url: https://www.nexscope.ai/api-docs license: name: Proprietary API; use subject to Nexscope Terms url: https://www.nexscope.ai/terms servers: - url: https://api.nexscope.ai description: Production security: - bearerAuth: [] tags: - name: Amazon Marketplace Intelligence description: Amazon product, search, market, review, traffic and policy APIs. x-category-slug: amazon-marketplace-intelligence paths: /api/skill-api/v1/skills/amazon-asin-traffic-summary/run: post: tags: - Amazon Marketplace Intelligence summary: Amazon Asin Traffic Summary description: Use SIF (Search Intelligence Framework) data to analyze ASIN traffic source composition and exposure distribution, covering current period/previous period/newly entered/exited period comparisons. operationId: runAmazonAsinTrafficSummary externalDocs: description: Amazon Asin Traffic Summary documentation url: https://www.nexscope.ai/api-docs/amazon-asin-traffic-summary requestBody: required: true content: application/json: schema: type: object description: Request parameters documented by ecommerce.amazon-asin-traffic-summary. properties: searchValue: type: string description: Search value, ASIN codes, comma-separated, max 10 ASINs, max length 1000 characters example: B072MQ5BRX country: type: string description: 'Country site, default US. Options (13 total): US, UK, DE, CA, JP, FR, ES, IT, MX, AU, AE, BR, SA' last7d: type: boolean description: Whether to get last 7 days data, default true. When false, use startDate/endDate range example: false startDate: type: string description: Start date yyyy-MM-dd (effective when last7d=false; if omitted, the latest system week is used) example: '2025-03-01' endDate: type: string description: End date yyyy-MM-dd (paired with startDate) example: '2025-03-31' conditions: type: string description: 'Condition filters, comma-separated. Options: nf (natural traffic), sp (SP ads), sb (SB regular), sbv (video ads), ad (ad traffic), acAd (SP recommendation), totalPeriod.in (new incoming traffic keywords)' sortBy: type: string description: 'Sort field. Options: totalKeywordNum (all traffic keywords), naturalKeywordNum (natural traffic keywords), brandKeywordNum (brand ad keywords), vedioKeywordNum (video ad keywords), acKeywordNum (AC recommended keywords), erKeywordNum (ER recommended keywords), trKeywordNum (TR recommended keywords), sumScore (total keyword exposure score), totalNfScore (total natural rank exposure score), totalSpSocre (total SP ad exposure score, note spelling), totalBrandScore (total brand ad exposure score), totalVedioScore (total video ad exposure score), totalAcScore (total AC recommendation exposure score), totalTrScore (total TR recommendation exposure score), totalErScore (total ER recommendation exposure score)' pageNum: type: integer description: Page number, default 1 example: 1 pageSize: type: integer description: Results per page, min 10, max 10000, default 10000 example: 10 desc: type: boolean description: Whether to sort descending, default true example: false required: - searchValue example: last7d: true pageSize: 10 desc: true pageNum: 1 country: US searchValue: B072MQ5BRX additionalProperties: true example: last7d: true pageSize: 10 desc: true pageNum: 1 country: US searchValue: B072MQ5BRX responses: '200': description: Successful response. content: application/json: schema: type: object description: Returns the documented upstream API response directly without an additional wrapper. properties: code: type: string description: Response code msg: type: string description: Message total: type: integer description: Number of data records actually returned example: 1 data: type: array items: type: object properties: asin: type: string description: ASIN code. Amazon Standard Identification Number example: B072MQ5BRX productTitle: type: string description: Product title productCategory: type: string description: Product category productPrice: type: number description: Product price example: 1 productImageUrl: type: string description: Product main image URL example: https://example.com/image.jpg productFeatures: type: array items: {} description: Product feature list example: [] customerRatingCount: type: integer description: Total customer rating count example: 1 productStarRating: type: number description: Product star rating (0-5 stars) example: 1 productRatingScore: type: number description: Product rating score value (0-5, as displayed on Amazon page) example: 1 isVariantProduct: type: boolean description: Whether it is a variant example: false recentMonthlySalesBucket: type: string description: Recent month sales bucket (only has value in keywordSummary path, e.g. "300+" or "1,000+") isMonitored: type: boolean description: Whether it is being monitored example: false monitoringStartTime: type: string description: Product monitoring start time dataPeriodStartDate: type: string description: Data period start date (yyyy-MM-dd) example: '2026-01-01' totalExposureScore: type: number description: Total exposure score. Composite exposure score of this product across all keywords example: 1 totalExposureScorePrev: type: number description: Previous period total exposure score example: 1 totalTrafficKeywordCount: type: integer description: Total traffic keyword count example: 1 totalTrafficKeywordCountIn: type: integer description: New incoming traffic keyword count for this period example: 1 totalTrafficKeywordCountOut: type: integer description: Outgoing traffic keyword count for this period example: 1 totalTrafficKeywordCountPrev: type: integer description: Previous period total traffic keyword count example: 1 naturalSearchExposureScore: type: number description: Natural search exposure total score example: 1 naturalSearchExposureRatio: type: number description: Natural search exposure ratio example: 1 naturalSearchExposureScorePrev: type: number description: Previous period natural search exposure score example: 1 naturalSearchKeywordCount: type: integer description: Natural search keyword count example: 1 naturalSearchKeywordCountIn: type: integer description: New incoming natural search keyword count for this period example: 1 naturalSearchKeywordCountOut: type: integer description: Outgoing natural search keyword count for this period example: 1 naturalSearchKeywordCountPrev: type: integer description: Previous period natural search keyword count example: 1 sponsoredProductsExposureScore: type: number description: SP ad exposure total score example: 1 sponsoredProductsExposureRatio: type: number description: SP ad exposure ratio example: 1 sponsoredProductsExposureScorePrev: type: number description: Previous period SP ad exposure score example: 1 sponsoredProductsKeywordCount: type: integer description: SP ad keyword count example: 1 brandAdExposureScore: type: number description: Brand ad exposure total score example: 1 brandAdExposureRatio: type: number description: Brand ad exposure ratio example: 1 brandAdExposureScorePrev: type: number description: Previous period brand ad exposure score example: 1 brandAdKeywordCount: type: integer description: Total brand ad keyword count example: 1 topBrandAdKeywordCount: type: integer description: Top-of-page brand ad keyword count example: 1 bottomBrandAdKeywordCount: type: integer description: Bottom-of-page brand ad keyword count example: 1 videoAdExposureScore: type: number description: Video ad exposure total score example: 1 videoAdExposureRatio: type: number description: Video ad exposure ratio example: 1 videoAdExposureScorePrev: type: number description: Previous period video ad exposure score example: 1 videoAdKeywordCount: type: integer description: Video ad keyword count example: 1 amazonsChoiceExposureScore: type: number description: Amazon's Choice exposure total score example: 1 amazonsChoiceExposureRatio: type: number description: Amazon's Choice exposure ratio example: 1 amazonsChoiceExposureScorePrev: type: number description: Previous period AC exposure score example: 1 amazonsChoiceKeywordCount: type: integer description: Amazon's Choice keyword count example: 1 amazonsChoiceKeywordCountIn: type: integer description: New incoming AC keyword count for this period example: 1 amazonsChoiceKeywordCountOut: type: integer description: Outgoing AC keyword count for this period example: 1 editorialRecommendationsExposureScore: type: number description: Editorial Recommendations exposure total score example: 1 editorialRecommendationsExposureRatio: type: number description: Editorial Recommendations exposure ratio example: 1 editorialRecommendationsKeywordCount: type: integer description: Editorial Recommendations keyword count example: 1 topRatedExposureScore: type: number description: Top Rated recommendation exposure total score example: 1 topRatedExposureRatio: type: number description: Top Rated recommendation exposure ratio example: 1 topRatedKeywordCount: type: integer description: Top Rated recommendation keyword count example: 1 frequentlyBoughtKeywordCount: type: integer description: Frequently Bought recommendation keyword count (Top Rated Frequently Bought) example: 1 recommendPositionExposureScore: type: number description: Recommendation position exposure total score example: 1 recommendAdExposureScore: type: number description: Recommendation position ad exposure score example: 1 recommendNonadExposureScore: type: number description: Recommendation position non-ad exposure score example: 1 nonAcRecommendExposureScore: type: number description: Non-AC recommendation position exposure score example: 1 recommendKeywordCount: type: integer description: Total recommendation position keyword count example: 1 recommendAdKeywordCount: type: integer description: Recommendation position ad keyword count example: 1 recommendNonadKeywordCount: type: integer description: Recommendation position non-ad keyword count example: 1 ppcTrafficSources: type: array items: {} description: 'PPC paid ad traffic source markers. Contains: SP ads, top brand ads, bottom brand ads, video ads' example: [] naturalSearchTrafficSources: type: array items: {} description: Natural search traffic source markers example: [] amazonRecommendationSources: type: array items: {} description: 'Amazon recommendation traffic source markers. Contains: Best Seller, AC, ER, TR, TRFOB, etc.' example: [] promotionalDealSources: type: array items: {} description: 'Promotional deal traffic source markers. Contains: Coupon, Limited Time Deal, Lowest Price in 30 Days, etc.' example: [] additionalProperties: true description: Return data, ASIN summary object array (see below) example: [] columns: type: array items: {} description: Render columns example: [] type: type: string description: Render style title: type: string description: Title isParentAsin: type: boolean description: Whether the search value is a parent ASIN example: false variantsNum: type: integer description: Number of variant products with keywords example: 1 noKeywordVariantsNum: type: integer description: Number of variant products without keywords example: 1 costTime: type: integer description: Latency (ms) example: 1 costToken: type: integer description: Tokens consumed example: 1 errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. message: type: string description: Provider-specific message. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. example: total: 1 data: - asin: B072MQ5BRX productPrice: 1 productImageUrl: https://example.com/image.jpg productFeatures: [] customerRatingCount: 1 productStarRating: 1 productRatingScore: 1 isVariantProduct: false isMonitored: false dataPeriodStartDate: '2026-01-01' totalExposureScore: 1 totalExposureScorePrev: 1 totalTrafficKeywordCount: 1 totalTrafficKeywordCountIn: 1 totalTrafficKeywordCountOut: 1 totalTrafficKeywordCountPrev: 1 naturalSearchExposureScore: 1 naturalSearchExposureRatio: 1 naturalSearchExposureScorePrev: 1 naturalSearchKeywordCount: 1 naturalSearchKeywordCountIn: 1 naturalSearchKeywordCountOut: 1 naturalSearchKeywordCountPrev: 1 sponsoredProductsExposureScore: 1 sponsoredProductsExposureRatio: 1 sponsoredProductsExposureScorePrev: 1 sponsoredProductsKeywordCount: 1 brandAdExposureScore: 1 brandAdExposureRatio: 1 brandAdExposureScorePrev: 1 brandAdKeywordCount: 1 topBrandAdKeywordCount: 1 bottomBrandAdKeywordCount: 1 videoAdExposureScore: 1 videoAdExposureRatio: 1 videoAdExposureScorePrev: 1 videoAdKeywordCount: 1 amazonsChoiceExposureScore: 1 amazonsChoiceExposureRatio: 1 amazonsChoiceExposureScorePrev: 1 amazonsChoiceKeywordCount: 1 amazonsChoiceKeywordCountIn: 1 amazonsChoiceKeywordCountOut: 1 editorialRecommendationsExposureScore: 1 editorialRecommendationsExposureRatio: 1 editorialRecommendationsKeywordCount: 1 topRatedExposureScore: 1 topRatedExposureRatio: 1 topRatedKeywordCount: 1 frequentlyBoughtKeywordCount: 1 recommendPositionExposureScore: 1 recommendAdExposureScore: 1 recommendNonadExposureScore: 1 nonAcRecommendExposureScore: 1 recommendKeywordCount: 1 recommendAdKeywordCount: 1 recommendNonadKeywordCount: 1 ppcTrafficSources: [] naturalSearchTrafficSources: [] amazonRecommendationSources: [] promotionalDealSources: [] columns: [] isParentAsin: false variantsNum: 1 noKeywordVariantsNum: 1 costTime: 1 costToken: 1 additionalProperties: true example: total: 1 data: - asin: B072MQ5BRX productPrice: 1 productImageUrl: https://example.com/image.jpg productFeatures: [] customerRatingCount: 1 productStarRating: 1 productRatingScore: 1 isVariantProduct: false isMonitored: false dataPeriodStartDate: '2026-01-01' totalExposureScore: 1 totalExposureScorePrev: 1 totalTrafficKeywordCount: 1 totalTrafficKeywordCountIn: 1 totalTrafficKeywordCountOut: 1 totalTrafficKeywordCountPrev: 1 naturalSearchExposureScore: 1 naturalSearchExposureRatio: 1 naturalSearchExposureScorePrev: 1 naturalSearchKeywordCount: 1 naturalSearchKeywordCountIn: 1 naturalSearchKeywordCountOut: 1 naturalSearchKeywordCountPrev: 1 sponsoredProductsExposureScore: 1 sponsoredProductsExposureRatio: 1 sponsoredProductsExposureScorePrev: 1 sponsoredProductsKeywordCount: 1 brandAdExposureScore: 1 brandAdExposureRatio: 1 brandAdExposureScorePrev: 1 brandAdKeywordCount: 1 topBrandAdKeywordCount: 1 bottomBrandAdKeywordCount: 1 videoAdExposureScore: 1 videoAdExposureRatio: 1 videoAdExposureScorePrev: 1 videoAdKeywordCount: 1 amazonsChoiceExposureScore: 1 amazonsChoiceExposureRatio: 1 amazonsChoiceExposureScorePrev: 1 amazonsChoiceKeywordCount: 1 amazonsChoiceKeywordCountIn: 1 amazonsChoiceKeywordCountOut: 1 editorialRecommendationsExposureScore: 1 editorialRecommendationsExposureRatio: 1 editorialRecommendationsKeywordCount: 1 topRatedExposureScore: 1 topRatedExposureRatio: 1 topRatedKeywordCount: 1 frequentlyBoughtKeywordCount: 1 recommendPositionExposureScore: 1 recommendAdExposureScore: 1 recommendNonadExposureScore: 1 nonAcRecommendExposureScore: 1 recommendKeywordCount: 1 recommendAdKeywordCount: 1 recommendNonadKeywordCount: 1 ppcTrafficSources: [] naturalSearchTrafficSources: [] amazonRecommendationSources: [] promotionalDealSources: [] columns: [] isParentAsin: false variantsNum: 1 noKeywordVariantsNum: 1 costTime: 1 costToken: 1 '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: amazon-asin-traffic-summary x-nexscope-mcp-tool-name: nexscope_amazon_asin_traffic_summary x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/amazon-broad-product-search/run: post: tags: - Amazon Marketplace Intelligence summary: Amazon Broad Product Search description: Use SellerSprite data to search and filter Amazon products, supporting multi-dimensional criteria including price, monthly sales, BSR ranking, gross margin, ratings, fulfillment method, badges, seller origin, and more across multiple Amazon marketplaces. operationId: runAmazonBroadProductSearch externalDocs: description: Amazon Broad Product Search documentation url: https://www.nexscope.ai/api-docs/amazon-broad-product-search requestBody: required: true content: application/json: schema: type: object description: Request parameters documented by ecommerce.amazon-broad-product-search. properties: chatId: type: string description: Chat ID, maxLength 1000 example: example-id uid: type: string description: User ID, maxLength 1000 example: example-id requestId: type: string description: Push ID, maxLength 1000 example: example-id teamId: type: string description: Team ID, maxLength 1000 example: example-id keyword: type: string description: Search keyword; translate to the corresponding country's language whenever possible, e.g. use English keywords for the US, German keywords for Germany, etc.; maxLength 10240 example: phone case matchType: type: integer description: 'Match type: 1 = phrase match (default), 2 = fuzzy match, 3 = exact match' example: 1 excludeKeywords: type: string description: Exclude keywords; maxLength 10240 example: phone case marketplace: type: string description: Marketplace site code, default US. Only US, UK, DE, FR, JP, CA, IT, ES, MX, IN are allowed (must match this enum; AU, TR, and other unlisted sites are not supported) example: US nodeLabel: type: string description: Amazon category name; maxLength 1000 nodeIdPath: type: string description: Amazon category node ID; maxLength 1000 filterSubNode: type: boolean description: Whether to filter subcategory nodes; only effective when nodeLabel or nodeIdPath has a value; pass JSON boolean true / false example: false dataSnapshotMonth: type: string description: 'Product data snapshot month, format yyyyMM (e.g. 202412 for December 2024 data snapshot), or nearly for last 30 days real-time data. Default: nearly. Used for historical analysis and period comparison; only supports existing historical snapshots, future dates are not supported; maxLength 1000' minPrice: type: number description: Minimum price (>= 0) example: 1 maxPrice: type: number description: Maximum price (>= 0) example: 1 minProfit: type: number description: Minimum gross margin, unit % (1-100) example: 1 maxProfit: type: number description: Maximum gross margin, unit % (1-100) example: 1 minRevenue: type: number description: Minimum monthly sales revenue (>= 0) example: 1 maxRevenue: type: number description: Maximum monthly sales revenue (>= 0) example: 1 minFba: type: number description: Minimum FBA shipping fee (>= 0) example: 1 maxFba: type: number description: Maximum FBA shipping fee (>= 0) example: 1 minUnits: type: integer description: Minimum monthly sales volume (>= 0) example: 1 maxUnits: type: integer description: Maximum monthly sales volume (>= 0) example: 1 minAmzUnit: type: integer description: Minimum variant last-30-day sales volume (only supported when dataSnapshotMonth is a "last 30 days" type query); minimum 0 example: 1 maxAmzUnit: type: integer description: Maximum variant last-30-day sales volume (only supported for last 30 days queries); minimum 0 example: 1 minUnitsGrowthRate: type: number description: Minimum monthly sales volume growth rate, unit % example: 1 maxUnitsGrowthRate: type: number description: Maximum monthly sales volume growth rate, unit % example: 1 minBsr: type: integer description: Lowest main category BSR rank example: 1 maxBsr: type: integer description: Highest main category BSR rank example: 1 minBsrGrowthRate: type: number description: Minimum BSR growth rate, unit % example: 1 maxBsrGrowthRate: type: number description: Maximum BSR growth rate, unit % example: 1 minBsrGrowthCount: type: integer description: Minimum BSR growth count example: 1 maxBsrGrowthCount: type: integer description: Maximum main category BSR growth count example: 1 minSubNodeBsrRank: type: integer description: Lowest subcategory BSR rank (requires filterSubNode = true) example: 1 maxSubNodeBsrRank: type: integer description: Highest subcategory BSR rank (requires filterSubNode = true) example: 1 minRating: type: number description: Minimum rating value (0-5) example: 1 maxRating: type: number description: Maximum rating value (0-5), 3.8-4.3 is the product improvement opportunity range example: 1 minRatings: type: integer description: Minimum review count (0-10000) example: 1 maxRatings: type: integer description: Maximum review count (0-10000) example: 1 minRatingsGrowthCount: type: integer description: Minimum monthly new review count (>= 0) example: 1 maxRatingsGrowthCount: type: integer description: Maximum monthly new review count (>= 0) example: 1 minListingQualityScore: type: number description: Minimum Listing page quality score (>= 0) example: 1 maxListingQualityScore: type: number description: Maximum Listing page quality score (>= 0) example: 1 minVariations: type: integer description: Minimum number of variations example: 1 maxVariations: type: integer description: Maximum number of variations example: 1 minWeights: type: number description: Minimum weight (>= 0) example: 1 maxWeights: type: number description: Maximum weight (>= 0) example: 1 weightUnit: type: string description: 'Weight unit: g, kg, oz, lb. This field must be specified if the parameters include weight filtering' dimensionType: type: string description: Package dimension type (codes vary by site, see below) minSellers: type: integer description: Minimum number of sellers example: 1 maxSellers: type: integer description: Maximum number of sellers example: 1 badgeBestSeller: type: string description: 'Best Seller badge filter: Y, N, or empty (all)' badgeAmazonsChoice: type: string description: 'Amazon''s Choice badge filter: Y, N, or empty (all)' badgeNewRelease: type: string description: 'New Release badge filter: Y, N, or empty (all)' fulfillment: type: string description: 'Fulfillment method: single select AMZ / FBA / FBM, or multi-select such as AMZ,FBA, FBA,FBM, AMZ,FBA,FBM, etc.; multiple conditions use comma separation; empty means no limit' showVariation: type: string description: 'Whether to query variants: Y or N, default N' hideUnlistedProduct: type: boolean description: Whether to hide delisted products, default true example: false listedWithinLastMonths: type: integer description: 'Time since listing (months), only allowed: 1, 3, 6, 12, 24 (must match these enum values; do not pass other integers)' example: 1 sellerNation: type: string description: Seller location code (e.g. US, CN, HK), multiple conditions comma-separated, default no limit includeSellers: type: string description: Include sellers; maxLength 10240 excludeSellers: type: string description: Exclude sellers; maxLength 10240 includeBrands: type: string description: Include brands; maxLength 10240 excludeBrands: type: string description: Exclude brands; maxLength 10240 order: type: object description: Sort configuration; if passed, it is recommended to provide both field and desc (both are required in the sub-schema) example: {} properties: field: type: string description: 'Sort field: total_units (monthly sales), total_amount (monthly revenue), bsr_rank, price, rating, reviews, profit, reviews_rate, available_date, questions, total_units_growth, total_amount_growth, reviews_increasement, bsr_rank_cv, bsr_rank_cr, amz_unit (variant sales). Default total_units. Pass an empty string "" to not sort by the above business fields (full query sort semantics are handled by the server)' desc: type: string description: '"true" descending, "false" ascending; default "true"; maxLength 1000' additionalProperties: true page: type: integer description: Page number, starting from 1, default 1 example: 1 size: type: integer description: Results per page (10-100), default 20 example: 20 example: marketplace: US matchType: 1 keyword: phone case size: 20 page: 1 additionalProperties: true example: marketplace: US matchType: 1 keyword: phone case size: 20 page: 1 responses: '200': description: Successful response. content: application/json: schema: type: object description: Returns the documented upstream API response directly without an additional wrapper. properties: total: type: integer description: Total matching product count example: 1 products: type: array items: type: object properties: nodeIdPath: type: string description: Node ID path nodeLabel: type: string description: Amazon category name asin: type: string description: Amazon ASIN example: B072MQ5BRX title: type: string description: Product title asinUrl: type: string description: Amazon product detail page URL example: B072MQ5BRX imageUrl: type: string description: Product image URL example: https://example.com/image.jpg price: type: number description: Current price example: 1 averagePrice: type: number description: Average price example: 1 primePrice: type: number description: Prime price, -1 means not available example: 1 currency: type: string description: Currency monthlySalesUnits: type: integer description: Monthly sales volume example: 1 monthlySalesRevenue: type: number description: Monthly sales revenue example: 1 monthlySalesUnitsGrowthRate: type: number description: Monthly sales volume growth rate example: 1 bsr: type: integer description: BSR rank example: 1 bsrGrowthRate: type: number description: BSR growth rate example: 1 rating: type: number description: Rating example: 1 ratings: type: integer description: Review count example: 1 ratingsRate: type: number description: Review rate example: 1 profit: type: number description: Gross margin (%) example: 1 fba: type: number description: FBA shipping fee example: 1 sellerNum: type: integer description: Number of sellers example: 1 sellerId: type: string description: BuyBox seller ID example: example-id sellerName: type: string description: BuyBox seller name sellerNation: type: string description: BuyBox seller nationality brand: type: string description: Brand brandUrl: type: string description: Brand page URL example: https://example.com/image.jpg fulfillment: type: string description: Fulfillment method (AMZ / FBA / FBM) availableDate: type: string description: Listing time (timestamp) example: '2026-01-01' availableDateString: type: string description: Listing date (formatted string) example: '2026-01-01' variationNum: type: integer description: Number of variations example: 1 variant30DayUnits: type: integer description: Variant monthly sales (units) example: 1 variant30DayRevenue: type: number description: Variant monthly sales revenue (amount) example: 1 variant30DayUpdatedAt: type: string description: Variant data update time example: '2026-01-01' weight: type: string description: Weight packageWeight: type: string description: Package weight dimension: type: string description: Dimensions packageDimensions: type: string description: Package dimensions dimensionsType: type: string description: Dimension type packageDimensionType: type: string description: Package dimension type listingQualityScore: type: number description: Listing quality score example: 1 deliveryPrice: type: number description: Seller shipping fee, -1 means not available example: 1 nodeLabelPath: type: string description: Category path nodeId: type: integer description: Node ID example: 1 dataSnapshotMonth: type: string description: Data query month badgeBestSeller: type: string description: Best Seller badge (Y/N) badgeAmazonChoice: type: string description: Amazon's Choice badge (Y/N) badgeNewRelease: type: string description: New Release badge (Y/N) badgeVideo: type: string description: Video introduction (Y/N) badgeEbc: type: string description: A+ page (Y/N) badge: type: object description: 'Badge summary object, containing: bestSeller, amazonChoice, newRelease, video, ebc' example: {} properties: {} additionalProperties: true subcategories: type: array items: {} description: Subcategory list, each entry containing code (category code), rank (rank), label (name) example: [] sku: type: string description: SKU keyword: type: string description: Matching keyword example: phone case sourceType: type: string description: Source type sourceTool: type: string description: Source tool identifier additionalProperties: true description: Product list (see product object fields below) example: [] columns: type: array items: {} description: Render column definitions example: [] keyword: type: string description: Search keyword used (if any) example: phone case dataSnapshotMonth: type: string description: Data query month sourceType: type: string description: Source type (e.g. "amazon") type: type: string description: Render style message: type: string description: Additional message or error info costToken: type: integer description: Tokens consumed example: 1 errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. title: type: string description: Provider-specific response title. sourceTool: type: string description: Provider-specific source tool name. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. example: total: 1 products: - asin: B072MQ5BRX asinUrl: B072MQ5BRX imageUrl: https://example.com/image.jpg price: 1 averagePrice: 1 primePrice: 1 monthlySalesUnits: 1 monthlySalesRevenue: 1 monthlySalesUnitsGrowthRate: 1 bsr: 1 bsrGrowthRate: 1 rating: 1 ratings: 1 ratingsRate: 1 profit: 1 fba: 1 sellerNum: 1 sellerId: example-id brandUrl: https://example.com/image.jpg availableDate: '2026-01-01' availableDateString: '2026-01-01' variationNum: 1 variant30DayUnits: 1 variant30DayRevenue: 1 variant30DayUpdatedAt: '2026-01-01' listingQualityScore: 1 deliveryPrice: 1 nodeId: 1 badge: {} subcategories: [] keyword: phone case columns: [] keyword: phone case costToken: 1 additionalProperties: true example: total: 1 products: - asin: B072MQ5BRX asinUrl: B072MQ5BRX imageUrl: https://example.com/image.jpg price: 1 averagePrice: 1 primePrice: 1 monthlySalesUnits: 1 monthlySalesRevenue: 1 monthlySalesUnitsGrowthRate: 1 bsr: 1 bsrGrowthRate: 1 rating: 1 ratings: 1 ratingsRate: 1 profit: 1 fba: 1 sellerNum: 1 sellerId: example-id brandUrl: https://example.com/image.jpg availableDate: '2026-01-01' availableDateString: '2026-01-01' variationNum: 1 variant30DayUnits: 1 variant30DayRevenue: 1 variant30DayUpdatedAt: '2026-01-01' listingQualityScore: 1 deliveryPrice: 1 nodeId: 1 badge: {} subcategories: [] keyword: phone case columns: [] keyword: phone case costToken: 1 '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: amazon-broad-product-search x-nexscope-mcp-tool-name: nexscope_amazon_broad_product_search x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/amazon-category-lookup/run: post: tags: - Amazon Marketplace Intelligence summary: Amazon Category Lookup description: Supports exact parent-node browsing and label-based category search. operationId: runAmazonCategoryLookup externalDocs: description: Amazon Category Lookup documentation url: https://www.nexscope.ai/api-docs/amazon-category-lookup requestBody: required: true content: application/json: schema: type: object description: Use lookup to browse nodes. Use like with nodeLabel to search category names. properties: operation: type: string description: lookup (default) or like. example: lookup marketId: type: string description: Amazon marketplace or site identifier. example: '1' nodeId: type: string description: Parent category node identifier. example: '0' table: type: string description: Optional upstream category table selector. example: nodes nodeLabel: type: string description: Category label required by operation=like. example: Electronics example: marketId: '1' operation: lookup nodeId: '0' additionalProperties: true example: marketId: '1' operation: lookup nodeId: '0' responses: '200': description: Successful response. content: application/json: schema: type: object description: Returns the category gateway payload directly. properties: total: type: integer description: Number of returned category nodes. example: 1 data: type: array items: type: object properties: nodeId: type: string description: Category node identifier. example: '172282' nodeLabel: type: string description: Category label. example: Electronics parentNodeId: type: string description: Parent node identifier. example: '0' additionalProperties: true description: Amazon category node records. example: [] costToken: type: integer description: Provider-reported token cost. example: 150 errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. message: type: string description: Provider-specific message. type: type: string description: Provider-specific render or payload type. title: type: string description: Provider-specific response title. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. example: total: 1 data: - nodeId: '172282' nodeLabel: Electronics parentNodeId: '0' costToken: 150 additionalProperties: true example: total: 1 data: - nodeId: '172282' nodeLabel: Electronics parentNodeId: '0' costToken: 150 '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: amazon-category-lookup x-nexscope-mcp-tool-name: nexscope_amazon_category_lookup x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/amazon-competitor-lookup/run: post: tags: - Amazon Marketplace Intelligence summary: Amazon Competitor Lookup description: Use SellerSprite data to find and analyze competitors on Amazon, covering 12 marketplaces, with product metrics including sales, BSR, pricing, ratings, and growth trends. operationId: runAmazonCompetitorLookup externalDocs: description: Amazon Competitor Lookup documentation url: https://www.nexscope.ai/api-docs/amazon-competitor-lookup requestBody: required: true content: application/json: schema: type: object description: Request parameters documented by ecommerce.amazon-competitor-lookup. properties: marketplace: type: string description: 'Amazon site code, default US. Options: US, UK, DE, FR, JP, CA, IT, ES, MX, AU, TR, IN' example: US keyword: type: string description: 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: type: string description: 'ASINs, multiple ASINs comma-separated, max 40. Format: ^[A-Z0-9]+(,[A-Z0-9]+){0,39}$' example: B072MQ5BRX sellerName: type: string description: Seller name filter brand: type: string description: Brand name filter nodeLabel: type: string description: Amazon category name, supports multi-level category names, levels separated by colon :, e.g. Electronics:Headphones nodeIdPath: type: string description: Amazon category ID path matchType: type: integer description: Match type. 1 = phrase match (default), 2 = fuzzy match, 3 = exact match example: 1 showVariation: type: string description: Whether to query variants. Y = yes, N = no (default) dataSnapshotMonth: type: string description: 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 page: type: integer description: Page number, starting from 1 (default 1) example: 1 size: type: integer description: Results per page, returns 10-100 records (default 50) example: 10 order: type: object description: Sort configuration (see below) example: {} properties: {} additionalProperties: true example: page: 1 keyword: phone case marketplace: US size: 10 matchType: 1 asinList: B072MQ5BRX additionalProperties: true example: page: 1 keyword: phone case marketplace: US size: 10 matchType: 1 asinList: B072MQ5BRX responses: '200': description: Successful response. content: application/json: schema: type: object description: Returns the documented upstream API response directly without an additional wrapper. properties: total: type: integer description: Total matching result count example: 1 sourceType: type: string description: Source type (e.g. amazon) message: type: string description: Execution message or error description type: type: string description: Render style products: type: array items: type: object properties: asin: type: string description: Product ASIN example: B072MQ5BRX title: type: string description: Product title price: type: number description: Current price example: 1 primePrice: type: number description: Prime price example: 1 averagePrice: type: number description: Average price example: 1 currency: type: string description: Currency monthlySalesUnits: type: integer description: Monthly sales volume (units) example: 1 monthlySalesRevenue: type: number description: Monthly sales revenue example: 1 monthlySalesUnitsGrowthRate: type: number description: Monthly sales volume growth rate example: 1 bsr: type: integer description: BSR rank example: 1 bsrGrowthRate: type: number description: BSR growth rate example: 1 bsrGrowthCount: type: integer description: BSR growth count example: 1 rating: type: number description: Rating example: 1 ratings: type: integer description: Review count example: 1 ratingsGrowth: type: integer description: Monthly new review count example: 1 ratingsRate: type: number description: Review rate example: 1 brand: type: string description: Brand brandUrl: type: string description: Brand URL example: https://example.com/image.jpg sellerName: type: string description: BuyBox seller name sellerId: type: string description: BuyBox seller ID example: example-id sellerNation: type: string description: BuyBox seller nationality sellerNum: type: integer description: Number of sellers example: 1 fulfillment: type: string description: 'Fulfillment method: AMZ, FBA, FBM' availableDate: type: string description: Listing time (date format) example: '2026-01-01' availableDateString: type: string description: Listing date (string format) example: '2026-01-01' profit: type: number description: Gross margin example: 1 fba: type: number description: FBA shipping fee example: 1 deliveryPrice: type: number description: Seller shipping fee example: 1 imageUrl: type: string description: Product image URL example: https://example.com/image.jpg parent: type: string description: Parent ASIN variationNum: type: integer description: Number of variations example: 1 variant30DayUnits: type: integer description: Variant monthly sales (units) example: 1 variant30DayRevenue: type: number description: Variant monthly sales revenue example: 1 variant30DayUpdatedAt: type: string description: Variant data update time (timestamp) example: '2026-01-01' amzUnitDateString: type: string description: Variant sales update date example: '2026-01-01' listingQualityScore: type: number description: Listing quality score example: 1 nodeLabelPath: type: string description: Category path nodeIdPath: type: string description: Node ID path nodeId: type: integer description: Node ID example: 1 dimension: type: string description: Product dimensions dimensionsType: type: string description: Dimension type weight: type: string description: Product weight packageDimensions: type: string description: Package dimensions packageDimensionType: type: string description: Package dimension type packageWeight: type: string description: Package weight sku: type: string description: SKU keyword: type: string description: Matching keyword (if searched by keyword, displays the corresponding keyword) example: phone case dataSnapshotMonth: type: string description: Data query month sourceTool: type: string description: Source tool sourceType: type: string description: Source type badgeBestSeller: type: string description: Best Seller badge (Y/N) badgeAmazonChoice: type: string description: Amazon's Choice badge (Y/N) badgeNewRelease: type: string description: New Release badge (Y/N) badgeEbc: type: string description: A+ page (Y/N) badgeVideo: type: string description: Video introduction (Y/N) badge: type: object description: 'Badge detail object, containing: bestSeller, amazonChoice, newRelease, ebc, video (all Y/N strings)' example: {} properties: {} additionalProperties: true subcategories: type: array items: {} description: Subcategory rankings, each entry containing code (category code), rank (rank), label (name) example: [] additionalProperties: true description: Competitor list (see below) example: [] columns: type: array items: {} description: Render column definitions example: [] costToken: type: integer description: Tokens consumed example: 1 errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. title: type: string description: Provider-specific response title. sourceTool: type: string description: Provider-specific source tool name. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. example: 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 additionalProperties: true example: 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 '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: amazon-competitor-lookup x-nexscope-mcp-tool-name: nexscope_amazon_competitor_lookup x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/amazon-market-product-detail/run: post: tags: - Amazon Marketplace Intelligence summary: Amazon Market Product Detail description: Query Amazon product detail and historical trends by ASIN using Sorftime data, covering 14 marketplaces. operationId: runAmazonMarketProductDetail externalDocs: description: Amazon Market Product Detail documentation url: https://www.nexscope.ai/api-docs/amazon-market-product-detail requestBody: required: true content: application/json: schema: type: object description: Request parameters documented by ecommerce.amazon-market-product-detail. properties: asin: type: string description: 'Amazon Standard Identification Number (ASIN), supports multiple (max 10), comma-separated. Example: B0088PUEPK or B0088PUEPK,B00U26V4VQ' example: B072MQ5BRX marketplace: type: string description: 'Amazon site code: us, gb, de, fr, in, ca, jp, es, it, mx, ae, au, br, sa' example: us includeTrend: type: integer description: 'Whether to include trend data. 1: include (default); 2: exclude' example: 1 queryTrendStartDate: type: string description: Trend start date, format yyyy-MM-dd. Default returns only the last 15 days; querying more than 15 days doubles the cost example: '2026-01-01' queryTrendEndDate: type: string description: Trend end date, format yyyy-MM-dd example: '2026-01-15' required: - asin - marketplace example: queryTrendEndDate: '2026-01-15' marketplace: us asin: B072MQ5BRX includeTrend: 1 queryTrendStartDate: '2026-01-01' additionalProperties: true example: queryTrendEndDate: '2026-01-15' marketplace: us asin: B072MQ5BRX includeTrend: 1 queryTrendStartDate: '2026-01-01' responses: '200': description: Successful response. content: application/json: schema: type: object description: Returns the documented upstream API response directly without an additional wrapper. properties: code: type: integer description: Response code (200 indicates success) example: 1 msg: type: string description: Response message total: type: integer description: Total result count example: 1 costTime: type: integer description: Latency (ms) example: 1 costToken: type: integer description: Tokens consumed example: 1 requestConsumed: type: integer description: Requests consumed example: 1 sourceType: type: string description: 'Source type: sorftime' type: type: string description: Render style columns: type: array items: {} description: Render columns example: [] products: type: array items: type: object properties: asin: type: string description: ASIN example: B072MQ5BRX title: type: string description: Product title brand: type: string description: Brand asinUrl: type: string description: Product link, Amazon Listing detail page URL example: B072MQ5BRX imageUrl: type: string description: Main image URL example: https://example.com/image.jpg productImageUrls: type: array items: {} description: Main image list (all product image URLs) example: [] ebcPhoto: type: array items: {} description: A+ image list example: [] storeName: type: string description: Store name description: type: string description: Five bullet points productBadge: type: array items: {} description: Product badges, e.g. Amazon Choice, Best Seller, New Release, etc. example: [] lastUpdate: type: string description: Update time, most recent ASIN data collection time (format yyyy-MM-dd) example: '2026-01-01' offSale: type: boolean description: Whether delisted. true = unavailable, false = available example: false productType: type: string description: Category, Amazon product category node name weight: type: string description: Weight, unit g size: type: array items: {} description: Dimensions, outer packaging [longest side, second longest side, shortest side], unit cm example: [] parentAsin: type: string description: Parent ASIN, the parent ASIN if variants exist, null if no variants example: B072MQ5BRX variationNum: type: integer description: Number of variations example: 1 variationASIN: type: array items: {} description: Child ASIN list, empty if no variants example: [] attribute: type: array items: {} description: Product attributes, variant attributes if variants exist. Each entry contains asin (child ASIN), name (attribute name), value (attribute value) example: [] price: type: number description: Selling price, actual price after coupon deduction, in local currency (e.g. USD) example: 1 coupon: type: integer description: Coupon policy. Value >= 0 = deduction amount (e.g. 500 = $5), value < 0 = discount percentage (e.g. -10 = 10% discount) example: 1 platformFee: type: number description: Platform commission, in local currency (e.g. USD) example: 1 fbaFees: type: number description: FBA fees, in local currency (e.g. USD) example: 1 fbaDetail: type: array items: {} description: FBA detail. First item is delivery fee, subsequent items are month:storage fee, e.g. [475,"1-9:5","10-12:15"] example: [] shipCost: type: number description: FBM shipping cost, in local currency (e.g. USD) example: 1 shipsFrom: type: string description: Ship-from location profitAmount: type: number description: Profit, final price - FBA fee - commission, in local currency (e.g. USD) example: 1 profitRate: type: number description: Profit margin, e.g. 25.83 means 25.83% example: 1 monthlySalesUnits: type: integer description: Official monthly sales volume, Amazon published ASIN monthly sales, latest value from the last 7 calendar days, 0 if unavailable example: 1 salesRank: type: integer description: BSR rank, main category rank example: 1 category: type: array items: {} description: Main category, [category name, NodeId] example: [] bsrCategory: type: array items: {} description: Subcategory rank list, each entry containing nodeId (node ID), name (category name), rank (rank), date (date, format yyyyMMdd) example: [] availableDate: type: string description: Listing time, format yyyy-MM-dd example: '2026-01-01' onlineDays: type: integer description: Days since listing example: 1 rating: type: number description: Current rating (0.0-5.0, e.g. 4.70) example: 1 ratings: type: integer description: Number of ratings example: 1 fiveStarRatings: type: number description: 5-star percentage, e.g. 57.7 means 57.7% example: 1 fourStarRatings: type: number description: 4-star percentage example: 1 threeStarRatings: type: number description: 3-star percentage example: 1 twoStarRatings: type: number description: 2-star percentage example: 1 oneStarRatings: type: number description: 1-star percentage example: 1 buyboxSeller: type: string description: Buybox seller name buyBoxSellerId: type: string description: Buybox seller ID example: example-id buyboxSellerAddress: type: string description: Seller location, Buybox seller nationality (two-letter code e.g. CN, US), null if Amazon's own isFBA: type: boolean description: Whether FBA, whether Buybox seller uses FBA logistics example: false sellerNum: type: integer description: Number of sellers example: 1 aPlus: type: boolean description: Has A+ example: false hasVideo: type: boolean description: Has video example: false hasBrandStore: type: boolean description: Has brand store example: false feature: type: object description: Product feature ratings, features and star ratings collected by Amazon for this product, e.g. {"Battery life":4.0} example: {} properties: {} additionalProperties: true productInfo: type: object description: Product information, structured data from the Product Information section in the Listing example: {} properties: {} additionalProperties: true property: type: object description: Attribute list, including variant attributes and Bullet Points header descriptions example: {} properties: {} additionalProperties: true brandPromotion: type: string description: Brand promotion dealType: type: string description: Deal label extraSavings: type: array items: {} description: Associated promotions, e.g. [{Asin:xxx, Text:"Save 5%..."}] example: [] rankTrend: type: array items: {} description: BSR trend, main category rank change history, interleaved format [date, rank, ...] example: [] bsrRankTrend: type: array items: {} description: Subcategory rank trend, JSON format [{NodeId:xxx, Rank:[date, rank, ...]}] example: [] listingSalesVolumeOfDailyTrend: type: array items: {} description: Daily sales volume trend, value -1 means unable to estimate example: [] listingSalesOfDailyTrend: type: array items: {} description: Daily sales revenue trend, in local currency smallest unit (e.g. cents), value -1 means unable to estimate example: [] listingSalesVolumeOfMonthTrend: type: array items: {} description: Monthly sales volume trend (last 30 days), value -1 means unable to estimate example: [] listingSalesOfMonthTrend: type: array items: {} description: Monthly sales revenue trend, in local currency smallest unit (e.g. cents) example: [] priceTrend: type: array items: {} description: Selling price trend, before coupon, in local currency smallest unit, -1 means no price available for that day example: [] listPriceTrend: type: array items: {} description: Original price trend (strikethrough price history), in local currency smallest unit, -1 means no price available for that day example: [] dealTrend: type: array items: {} description: Deal trend, value 1 = has deal, 0 = no deal example: [] additionalProperties: true description: Product detail list (see below) example: [] errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. message: type: string description: Provider-specific message. title: type: string description: Provider-specific response title. sourceTool: type: string description: Provider-specific source tool name. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. example: code: 1 total: 1 costTime: 1 costToken: 1 requestConsumed: 1 columns: [] products: - asin: B072MQ5BRX asinUrl: B072MQ5BRX imageUrl: https://example.com/image.jpg productImageUrls: [] ebcPhoto: [] productBadge: [] lastUpdate: '2026-01-01' offSale: false size: [] parentAsin: B072MQ5BRX variationNum: 1 variationASIN: [] attribute: [] price: 1 coupon: 1 platformFee: 1 fbaFees: 1 fbaDetail: [] shipCost: 1 profitAmount: 1 profitRate: 1 monthlySalesUnits: 1 salesRank: 1 category: [] bsrCategory: [] availableDate: '2026-01-01' onlineDays: 1 rating: 1 ratings: 1 fiveStarRatings: 1 fourStarRatings: 1 threeStarRatings: 1 twoStarRatings: 1 oneStarRatings: 1 buyBoxSellerId: example-id isFBA: false sellerNum: 1 aPlus: false hasVideo: false hasBrandStore: false feature: {} productInfo: {} property: {} extraSavings: [] rankTrend: [] bsrRankTrend: [] listingSalesVolumeOfDailyTrend: [] listingSalesOfDailyTrend: [] listingSalesVolumeOfMonthTrend: [] listingSalesOfMonthTrend: [] priceTrend: [] listPriceTrend: [] dealTrend: [] additionalProperties: true example: code: 1 total: 1 costTime: 1 costToken: 1 requestConsumed: 1 columns: [] products: - asin: B072MQ5BRX asinUrl: B072MQ5BRX imageUrl: https://example.com/image.jpg productImageUrls: [] ebcPhoto: [] productBadge: [] lastUpdate: '2026-01-01' offSale: false size: [] parentAsin: B072MQ5BRX variationNum: 1 variationASIN: [] attribute: [] price: 1 coupon: 1 platformFee: 1 fbaFees: 1 fbaDetail: [] shipCost: 1 profitAmount: 1 profitRate: 1 monthlySalesUnits: 1 salesRank: 1 category: [] bsrCategory: [] availableDate: '2026-01-01' onlineDays: 1 rating: 1 ratings: 1 fiveStarRatings: 1 fourStarRatings: 1 threeStarRatings: 1 twoStarRatings: 1 oneStarRatings: 1 buyBoxSellerId: example-id isFBA: false sellerNum: 1 aPlus: false hasVideo: false hasBrandStore: false feature: {} productInfo: {} property: {} extraSavings: [] rankTrend: [] bsrRankTrend: [] listingSalesVolumeOfDailyTrend: [] listingSalesOfDailyTrend: [] listingSalesVolumeOfMonthTrend: [] listingSalesOfMonthTrend: [] priceTrend: [] listPriceTrend: [] dealTrend: [] '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: amazon-market-product-detail x-nexscope-mcp-tool-name: nexscope_amazon_market_product_detail x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/amazon-market-product-search/run: post: tags: - Amazon Marketplace Intelligence summary: Amazon Market Product Search description: Multi-dimensional Amazon product search and filtering based on Sorftime data, covering 14 marketplaces, with support for historical monthly snapshot lookback. operationId: runAmazonMarketProductSearch externalDocs: description: Amazon Market Product Search documentation url: https://www.nexscope.ai/api-docs/amazon-market-product-search requestBody: required: true content: application/json: schema: type: object description: Request parameters documented by ecommerce.amazon-market-product-search. properties: marketplace: type: string description: 'Amazon site code: us, gb, de, fr, in, ca, jp, es, it, mx, ae, au, br, sa' example: us queryMode: type: integer description: 'Query mode. 1: single condition query (default); 2: multi-condition combined query (AND relationship)' example: 1 queryType: type: integer description: Query type (1-16), only effective when queryMode=1. See the complete Query Types description in SKILL.md example: 1 queryValue: type: string description: Query condition value, format varies by queryMode and queryType. See the format description for each queryType in SKILL.md example: phone case page: type: integer description: Page number, default 1. Max 100 products per page example: 1 queryMonth: type: string description: Historical month lookback, format yyyy-MM. When not specified, queries real-time data example: 2026-01 required: - marketplace example: queryMode: 1 marketplace: us queryType: 1 queryValue: B072MQ5BRX page: 1 additionalProperties: true example: queryMode: 1 marketplace: us queryType: 1 queryValue: B072MQ5BRX page: 1 responses: '200': description: Successful response. content: application/json: schema: type: object description: Returns the documented upstream API response directly without an additional wrapper. properties: code: type: integer description: Response code (200 indicates success) example: 1 msg: type: string description: Response message total: type: integer description: Total result count example: 1 page: type: integer description: Current page number example: 1 pageCount: type: integer description: Total page count (max 200 pages) example: 1 costTime: type: integer description: Latency (ms) example: 1 costToken: type: integer description: Tokens consumed example: 1 requestConsumed: type: integer description: Requests consumed example: 1 type: type: string description: Render style columns: type: array items: {} description: Render columns example: [] products: type: array items: type: object properties: asin: type: string description: ASIN example: B072MQ5BRX title: type: string description: Product title brand: type: string description: Brand asinUrl: type: string description: Product link, Amazon Listing detail page URL example: B072MQ5BRX imageUrl: type: string description: Main image URL example: https://example.com/image.jpg productImageUrls: type: array items: {} description: Main image list (all product image URLs) example: [] parentAsin: type: string description: Parent ASIN, the parent ASIN if variants exist, null if no variants example: B072MQ5BRX variationNum: type: integer description: Number of variations example: 1 weight: type: string description: Weight, unit g size: type: array items: {} description: Dimensions, outer packaging [longest side, second longest side, shortest side], unit cm example: [] price: type: number description: Current price, before coupon, in local currency (e.g. USD) example: 1 oldPrice: type: number description: Strikethrough price, in local currency (e.g. USD) example: 1 salesPrice: type: number description: Final price, actual price after coupon deduction, in local currency (e.g. USD) example: 1 coupon: type: integer description: Coupon policy. Value >= 0 = deduction amount (e.g. 500 = $5), value < 0 = discount percentage (e.g. -10 = 10% discount) example: 1 fbaFees: type: number description: FBA fees, in local currency (e.g. USD) example: 1 fbaDetail: type: array items: {} description: FBA detail. First item is delivery fee, subsequent items are month:storage fee, e.g. [475,"1-9:5","10-12:15"] example: [] platformFee: type: number description: Platform commission, in local currency (e.g. USD) example: 1 profitAmount: type: number description: Profit, final price - FBA fee - commission, in local currency (e.g. USD) example: 1 profitRate: type: number description: Profit margin, e.g. 25.83 means 25.83% example: 1 monthlySalesUnits: type: integer description: Monthly sales volume, last 30 days Listing-level (does not split by variant), recommended for evaluating sales, value -1 means unable to estimate example: 1 monthlySalesRevenue: type: number description: Monthly sales revenue, estimated value, in local currency (e.g. USD), value -1 means unable to estimate example: 1 listingSalesVolumeOfDaily: type: integer description: Daily sales volume, Listing-level (does not split by variant), value -1 means unable to estimate example: 1 listingSalesOfDaily: type: number description: Daily sales revenue, in local currency (e.g. USD), value -1 means unable to estimate example: 1 salesRank: type: integer description: BSR rank, main category rank example: 1 category: type: array items: {} description: Main category, [category name, NodeId] example: [] bsrCategory: type: array items: {} description: Subcategory rank list, each entry containing nodeId (node ID), name (category name), rank (rank), date (date, format yyyyMMdd) example: [] rating: type: number description: Current rating (0.0-5.0, e.g. 4.8) example: 1 ratings: type: integer description: Number of ratings example: 1 availableDate: type: string description: Listing time, format yyyy-MM-dd example: '2026-01-01' onlineDays: type: integer description: Days since listing example: 1 buyboxSeller: type: string description: Buybox seller name buyBoxSellerId: type: string description: Buybox seller ID example: example-id buyboxSellerAddress: type: string description: Seller location, Buybox seller nationality (two-letter code e.g. CN, US), null if Amazon's own isFBA: type: boolean description: Whether FBA, whether Buybox seller uses FBA logistics example: false sellerNum: type: integer description: Number of sellers example: 1 aPlus: type: boolean description: Has A+ example: false hasVideo: type: boolean description: Has video example: false hasBrandStore: type: boolean description: Has brand store example: false additionalProperties: true description: Product list (see below) example: [] errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. message: type: string description: Provider-specific message. title: type: string description: Provider-specific response title. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. example: code: 1 total: 1 page: 1 pageCount: 1 costTime: 1 costToken: 1 requestConsumed: 1 columns: [] products: - asin: B072MQ5BRX asinUrl: B072MQ5BRX imageUrl: https://example.com/image.jpg productImageUrls: [] parentAsin: B072MQ5BRX variationNum: 1 size: [] price: 1 oldPrice: 1 salesPrice: 1 coupon: 1 fbaFees: 1 fbaDetail: [] platformFee: 1 profitAmount: 1 profitRate: 1 monthlySalesUnits: 1 monthlySalesRevenue: 1 listingSalesVolumeOfDaily: 1 listingSalesOfDaily: 1 salesRank: 1 category: [] bsrCategory: [] rating: 1 ratings: 1 availableDate: '2026-01-01' onlineDays: 1 buyBoxSellerId: example-id isFBA: false sellerNum: 1 aPlus: false hasVideo: false hasBrandStore: false additionalProperties: true example: code: 1 total: 1 page: 1 pageCount: 1 costTime: 1 costToken: 1 requestConsumed: 1 columns: [] products: - asin: B072MQ5BRX asinUrl: B072MQ5BRX imageUrl: https://example.com/image.jpg productImageUrls: [] parentAsin: B072MQ5BRX variationNum: 1 size: [] price: 1 oldPrice: 1 salesPrice: 1 coupon: 1 fbaFees: 1 fbaDetail: [] platformFee: 1 profitAmount: 1 profitRate: 1 monthlySalesUnits: 1 monthlySalesRevenue: 1 listingSalesVolumeOfDaily: 1 listingSalesOfDaily: 1 salesRank: 1 category: [] bsrCategory: [] rating: 1 ratings: 1 availableDate: '2026-01-01' onlineDays: 1 buyBoxSellerId: example-id isFBA: false sellerNum: 1 aPlus: false hasVideo: false hasBrandStore: false '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: amazon-market-product-search x-nexscope-mcp-tool-name: nexscope_amazon_market_product_search x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/amazon-market-research/run: post: tags: - Amazon Marketplace Intelligence summary: Amazon Market Research description: Use SellerSprite market list capability to filter Amazon niche markets by category dimensions, supporting market size, competition, top concentration, seller structure, new product share, price/rating/margin ranges, and many other criteria for discovering viable markets and evaluating product selection directions. operationId: runAmazonMarketResearch externalDocs: description: Amazon Market Research documentation url: https://www.nexscope.ai/api-docs/amazon-market-research requestBody: required: true content: application/json: schema: type: object description: Request parameters documented by ecommerce.amazon-market-research. properties: marketplace: type: string description: Site code, see [marketplace](#marketplace-options) example: US nodeIdPath: type: string description: Category node ID path, e.g. 172282:281407 departmentKeyword: type: string description: Category keyword path, e.g. Electronics:Accessories & Supplies example: phone case sellerLocation: type: string description: Seller location, multiple values comma-separated; see Seller Sprite table 1.3 for values newProduct: type: integer description: New product definition (months) example: 1 topNum: type: integer description: Top Listing count example: 1 month: type: string description: 'Filter date: nearly or yyyyMM' page: type: integer description: Page number, starting from 1 example: 1 size: type: integer description: Results per page example: 1 orderField: type: string description: Sort field, see [orderField](#orderfield-options) orderDesc: type: boolean description: true descending, false ascending example: false minAvgRevenue/maxAvgRevenue: type: number description: Minimum / maximum average monthly sales revenue example: 1 minAvgUnits/maxAvgUnits: type: integer description: Minimum / maximum average monthly sales volume example: 1 minGoodsCount/maxGoodsCount: type: integer description: Minimum / maximum product count example: 1 minSellers/maxSellers: type: integer description: Minimum / maximum seller count example: 1 minBrands/maxBrands: type: integer description: Minimum / maximum brand count example: 1 minAvgSellers/maxAvgSellers: type: number description: Minimum / maximum average seller count example: 1 minGoodsCrn/maxGoodsCrn: type: number description: Minimum / maximum product concentration (decimal 0-1) example: 1 minSellerCrn/maxSellerCrn: type: number description: Minimum / maximum seller concentration (decimal 0-1) example: 1 minBrandCrn/maxBrandCrn: type: number description: Minimum / maximum brand concentration (decimal 0-1) example: 1 minAmazonSelfProportion/maxAmazonSelfProportion: type: number description: Minimum / maximum Amazon self-operated share (decimal 0-1) example: 1 minFbaProportion/maxFbaProportion: type: number description: Minimum / maximum FBA share (decimal 0-1) example: 1 minFbmProportion/maxFbmProportion: type: number description: Minimum / maximum FBM share (decimal 0-1) example: 1 minEbcProportion/maxEbcProportion: type: number description: Minimum / maximum A+ share (decimal 0-1) example: 1 minNewProportion/maxNewProportion: type: number description: Minimum / maximum new product share (scale may differ from other ratio fields; refer to tool schema / actual network behavior) example: 1 minAvgPrice/maxAvgPrice: type: number description: Minimum / maximum average price example: 1 minAvgRating/maxAvgRating: type: number description: Minimum / maximum average rating value example: 1 minAvgRatings/maxAvgRatings: type: integer description: Minimum / maximum average review count example: 1 minAvgProfit/maxAvgProfit: type: number description: Minimum / maximum average gross margin (input N means N%, 0-100) example: 1 minAvgBsr/maxAvgBsr: type: integer description: Minimum / maximum average BSR rank example: 1 minNewCount/maxNewCount: type: integer description: Minimum / maximum new product count example: 1 minNewAvgPrice/maxNewAvgPrice: type: number description: Minimum / maximum new product average price example: 1 minNewAvgRating/maxNewAvgRating: type: number description: Minimum / maximum new product average star rating example: 1 minNewAvgRatings/maxNewAvgRatings: type: integer description: Minimum / maximum new product average review count example: 1 minNewAvgUnits/maxNewAvgUnits: type: number description: Minimum / maximum new product average monthly sales example: 1 minNewAvgRevenue/maxNewAvgRevenue: type: number description: Minimum / maximum new product average monthly revenue example: 1 minTopAvgUnits/maxTopAvgUnits: type: integer description: Minimum / maximum top listing average monthly sales example: 1 minTopAvgRevenue/maxTopAvgRevenue: type: number description: Minimum / maximum top listing average monthly revenue example: 1 minTopAvgBsr/maxTopAvgBsr: type: integer description: Minimum / maximum top listing average BSR example: 1 minWeight/maxWeight: type: number description: Minimum / maximum weight example: 1 minVolume/maxVolume: type: number description: Minimum / maximum volume example: 1 required: - marketplace example: page: 1 topNum: 1 marketplace: US size: 1 newProduct: 1 departmentKeyword: phone case additionalProperties: true example: page: 1 topNum: 1 marketplace: US size: 1 newProduct: 1 departmentKeyword: phone case responses: '200': description: Successful response. content: application/json: schema: type: object description: Returns the documented upstream API response directly without an additional wrapper. properties: total: type: integer description: Total record count example: 1 marketplace: type: string description: Site code example: US data: type: array items: type: object properties: nodeId: type: string description: Node ID example: example-id nodeIdPath: type: string description: Node ID path nodeLabelName: type: string description: Node name nodeLabelPath: type: string description: Node name path nodeLabelLocale: type: string description: Node name translation nodeLabelPathLocale: type: string description: Node name path translation marketplace: type: string description: Market identifier example: US currency: type: string description: Currency type for this market ranking: type: integer description: Rank example: 1 totalProducts: type: integer description: Total product count example: 1 topProducts: type: integer description: Sample count example: 1 sellers: type: integer description: Seller count example: 1 brands: type: integer description: Brand count example: 1 avgSellers: type: number description: Average seller count example: 1 avgUnits: type: integer description: Average monthly sales volume example: 1 totalUnits: type: integer description: Total monthly sales volume example: 1 avgRevenue: type: number description: Average monthly sales revenue example: 1 totalRevenue: type: number description: Total monthly sales revenue example: 1 avgPrice: type: number description: Average price example: 1 avgRating: type: number description: Average rating value example: 1 avgRatings: type: integer description: Average review count example: 1 avgBsr: type: integer description: Average BSR example: 1 avgProfit: type: number description: Average profit margin (%) example: 1 fbaProportion: type: number description: FBA share (%) example: 1 fbmProportion: type: number description: FBM share (%) example: 1 amazonSelfProportion: type: number description: Amazon self-operated share (%) example: 1 ebcProportion: type: number description: A+ product share (%) example: 1 returnRatio: type: number description: Return rate (%) example: 1 avgReturnRatio: type: number description: Category average return rate (%) example: 1 searchToPurchaseRatio: type: number description: Search-to-purchase ratio (per mille) example: 1 sellerNation: type: string description: Most common seller location code sellerNationLabel: type: string description: Most common seller location label sellerProportion: type: number description: Most common seller location share (%) example: 1 avgWeight: type: number description: Average weight (pound) example: 1 baseAvgWeight: type: number description: Average weight (g) example: 1 avgVolume: type: number description: Average volume (in³) example: 1 baseAvgVolume: type: number description: Average volume (cm³) example: 1 top10Images: type: array items: {} description: Top 10 product images, elements see table below example: [] additionalProperties: true description: Category market list (corresponds to third-party data.items) example: [] columns: type: array items: {} description: Render columns example: [] costToken: type: integer description: Tokens consumed example: 1 type: type: string description: Render style top10images: type: array items: type: object properties: image: type: string description: Image link example: https://example.com/image.jpg asin: type: string description: ASIN example: B072MQ5BRX additionalProperties: true errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. message: type: string description: Provider-specific message. title: type: string description: Provider-specific response title. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. example: total: 1 marketplace: US data: - nodeId: example-id marketplace: US ranking: 1 totalProducts: 1 topProducts: 1 sellers: 1 brands: 1 avgSellers: 1 avgUnits: 1 totalUnits: 1 avgRevenue: 1 totalRevenue: 1 avgPrice: 1 avgRating: 1 avgRatings: 1 avgBsr: 1 avgProfit: 1 fbaProportion: 1 fbmProportion: 1 amazonSelfProportion: 1 ebcProportion: 1 returnRatio: 1 avgReturnRatio: 1 searchToPurchaseRatio: 1 sellerProportion: 1 avgWeight: 1 baseAvgWeight: 1 avgVolume: 1 baseAvgVolume: 1 top10Images: [] columns: [] costToken: 1 top10images: - image: https://example.com/image.jpg asin: B072MQ5BRX additionalProperties: true example: total: 1 marketplace: US data: - nodeId: example-id marketplace: US ranking: 1 totalProducts: 1 topProducts: 1 sellers: 1 brands: 1 avgSellers: 1 avgUnits: 1 totalUnits: 1 avgRevenue: 1 totalRevenue: 1 avgPrice: 1 avgRating: 1 avgRatings: 1 avgBsr: 1 avgProfit: 1 fbaProportion: 1 fbmProportion: 1 amazonSelfProportion: 1 ebcProportion: 1 returnRatio: 1 avgReturnRatio: 1 searchToPurchaseRatio: 1 sellerProportion: 1 avgWeight: 1 baseAvgWeight: 1 avgVolume: 1 baseAvgVolume: 1 top10Images: [] columns: [] costToken: 1 top10images: - image: https://example.com/image.jpg asin: B072MQ5BRX '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: amazon-market-research x-nexscope-mcp-tool-name: nexscope_amazon_market_research x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/amazon-market-statistics/run: post: tags: - Amazon Marketplace Intelligence summary: Amazon Market Statistics description: Use SellerSprite market statistics capability to output a market statistics dashboard by category node, including top listing average rating, average price, BSR, sales, seller count, and new product related metrics, suitable for quickly assessing the market quality and competitive landscape of a category. operationId: runAmazonMarketStatistics externalDocs: description: Amazon Market Statistics documentation url: https://www.nexscope.ai/api-docs/amazon-market-statistics requestBody: required: true content: application/json: schema: type: object description: Request parameters documented by ecommerce.amazon-market-statistics. properties: marketplace: type: string description: Site code, see [marketplace](#marketplace-options) example: US nodeIdPath: type: string description: Node ID path string, e.g. 1064954:1069242:1069784:1069820:1069838:1069828 example: 1064954:1069242 month: type: string description: 'Filter date: nearly or yyyyMM' topN: type: integer description: Top Listing count (used for top-related metric definitions) example: 1 newProduct: type: integer description: New product definition (months) example: 1 required: - marketplace - nodeIdPath example: newProduct: 1 marketplace: US nodeIdPath: 1064954:1069242 topN: 1 additionalProperties: true example: newProduct: 1 marketplace: US nodeIdPath: 1064954:1069242 topN: 1 responses: '200': description: Successful response. content: application/json: schema: type: object description: Returns the documented upstream API response directly without an additional wrapper. properties: total: type: integer description: Total record count example: 1 marketplace: type: string description: Site code example: US data: type: array items: type: object properties: nodeIdPath: type: string description: Node ID path nodeLabelPath: type: string description: Node name path nodeLabelLocale: type: string description: Node name translation nodeLabelPathLocale: type: string description: Node name path translation countryCode: type: string description: Two-letter country code currency: type: string description: Currency type for this market description: Statistics result list (corresponds to third-party data) example: [] columns: type: array items: {} description: Render columns example: [] costToken: type: integer description: Tokens consumed example: 1 type: type: string description: Render style totalProducts: type: integer description: Total product count example: 1 products: type: integer description: Sample product count example: 1 sellers: type: integer description: Seller count example: 1 brands: type: integer description: Brand count example: 1 avgSellers: type: number description: Average seller count example: 1 hlProducts: type: integer description: Top N Listing sample product count example: 1 avgUnits: type: integer description: Average monthly sales volume example: 1 avgRevenue: type: number description: Average monthly sales revenue example: 1 avgPrice: type: number description: Average price example: 1 avgRating: type: number description: Average star rating example: 1 avgRatings: type: integer description: Average review count example: 1 avgRatingsCv: type: integer description: Average monthly review growth count example: 1 avgBsr: type: integer description: Average BSR example: 1 avgProfit: type: number description: Average profit margin example: 1 avgWeight: type: number description: Average weight (pound) example: 1 baseAvgWeight: type: number description: Average weight (g) example: 1 avgVolume: type: number description: Average volume (in³) example: 1 baseAvgVolume: type: number description: Average volume (cm³) example: 1 hlAvgUnits: type: integer description: Top N Listing average monthly sales volume example: 1 hlAvgRevenue: type: number description: Top N Listing average monthly sales revenue example: 1 hlAvgPrice: type: number description: Top N Listing average price example: 1 hlAvgRating: type: number description: Top N Listing average star rating example: 1 hlAvgRatings: type: integer description: Top N Listing average review count example: 1 hlAvgRatingsCv: type: integer description: Top N Listing average monthly review growth count example: 1 hlAvgBsr: type: integer description: Top N Listing average BSR example: 1 newProducts: type: integer description: New product count example: 1 newProductProportion: type: number description: New product share example: 1 newAvgUnits: type: integer description: New product average monthly sales volume example: 1 newAvgRevenue: type: number description: New product average monthly sales revenue example: 1 newAvgPrice: type: number description: New product average price example: 1 newAvgRating: type: number description: New product average star rating example: 1 newAvgRatings: type: integer description: New product average review count example: 1 minNewRatings: type: integer description: Minimum new product review count example: 1 maxNewRatings: type: integer description: Maximum new product review count example: 1 firstShelfDate: type: string description: Product first listing date example: '2026-01-01' lastShelfDate: type: string description: Product latest listing date example: '2026-01-01' errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. message: type: string description: Provider-specific message. title: type: string description: Provider-specific response title. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. example: total: 1 marketplace: US data: [] columns: [] costToken: 1 totalProducts: 1 products: 1 sellers: 1 brands: 1 avgSellers: 1 hlProducts: 1 avgUnits: 1 avgRevenue: 1 avgPrice: 1 avgRating: 1 avgRatings: 1 avgRatingsCv: 1 avgBsr: 1 avgProfit: 1 avgWeight: 1 baseAvgWeight: 1 avgVolume: 1 baseAvgVolume: 1 hlAvgUnits: 1 hlAvgRevenue: 1 hlAvgPrice: 1 hlAvgRating: 1 hlAvgRatings: 1 hlAvgRatingsCv: 1 hlAvgBsr: 1 newProducts: 1 newProductProportion: 1 newAvgUnits: 1 newAvgRevenue: 1 newAvgPrice: 1 newAvgRating: 1 newAvgRatings: 1 minNewRatings: 1 maxNewRatings: 1 firstShelfDate: '2026-01-01' lastShelfDate: '2026-01-01' additionalProperties: true example: total: 1 marketplace: US data: [] columns: [] costToken: 1 totalProducts: 1 products: 1 sellers: 1 brands: 1 avgSellers: 1 hlProducts: 1 avgUnits: 1 avgRevenue: 1 avgPrice: 1 avgRating: 1 avgRatings: 1 avgRatingsCv: 1 avgBsr: 1 avgProfit: 1 avgWeight: 1 baseAvgWeight: 1 avgVolume: 1 baseAvgVolume: 1 hlAvgUnits: 1 hlAvgRevenue: 1 hlAvgPrice: 1 hlAvgRating: 1 hlAvgRatings: 1 hlAvgRatingsCv: 1 hlAvgBsr: 1 newProducts: 1 newProductProportion: 1 newAvgUnits: 1 newAvgRevenue: 1 newAvgPrice: 1 newAvgRating: 1 newAvgRatings: 1 minNewRatings: 1 maxNewRatings: 1 firstShelfDate: '2026-01-01' lastShelfDate: '2026-01-01' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: amazon-market-statistics x-nexscope-mcp-tool-name: nexscope_amazon_market_statistics x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/amazon-niche-info/run: post: tags: - Amazon Marketplace Intelligence summary: Amazon Niche Info description: Query and analyze Jiimore data for Amazon niche market insights, including market metrics, buyer reviews, competitive landscape, price trends, and growth trends. operationId: runAmazonNicheInfo externalDocs: description: Amazon Niche Info documentation url: https://www.nexscope.ai/api-docs/amazon-niche-info requestBody: required: true content: application/json: schema: type: object description: Request parameters documented by ecommerce.amazon-niche-info. properties: nicheId: type: string description: Niche market ID, max length 1000 characters, only supports single ID query example: dfecfecfa9701de73a08867d7bcd3bc0 countryCode: type: string description: Country code, only supports US, JP, DE, default US required: - nicheId example: countryCode: US nicheId: dfecfecfa9701de73a08867d7bcd3bc0 additionalProperties: true example: countryCode: US nicheId: dfecfecfa9701de73a08867d7bcd3bc0 responses: '200': description: Successful response. content: application/json: schema: type: object description: Returns the documented upstream API response directly without an additional wrapper. properties: total: type: integer description: Record count example: 1 data: type: array items: type: object properties: nicheTitle: type: string description: Niche market title translationZh: type: string description: Niche market title (Chinese) description: Niche market information list, each element is an object containing the fields below example: [] columns: type: array items: {} description: Render columns example: [] costToken: type: integer description: Tokens consumed example: 1 type: type: string description: Render style nicheId: type: string description: Niche market ID example: dfecfecfa9701de73a08867d7bcd3bc0 referenceAsinImageUrl: type: string description: Niche market reference image URL example: B072MQ5BRX marketplaceId: type: string description: Market ID example: US demand: type: integer description: Niche market score example: 1 categorieList: type: array items: {} description: Product category list example: [] productCount: type: integer description: Product count example: 1 productCountNow: type: integer description: Product count (current) example: 1 productCountT90Before: type: integer description: Product count (90 days ago) example: 1 productCountT360Before: type: integer description: Product count (360 days ago) example: 1 brandCount: type: integer description: Brand count example: 1 brandCountNow: type: integer description: Brand count (current) example: 1 brandCountT90Before: type: integer description: Brand count (90 days ago) example: 1 brandCountT360Before: type: integer description: Brand count (360 days ago) example: 1 brandCountT360Now: type: integer description: Brand count (360-day stats) (current) example: 1 brandCountT360T90Before: type: integer description: Brand count (360-day stats) (90 days ago) example: 1 brandCountT360T360Before: type: integer description: Brand count (360-day stats) (360 days ago) example: 1 sellingPartnerCountNow: type: integer description: Selling partner count (current) example: 1 sellingPartnerCountT90Before: type: integer description: Selling partner count (90 days ago) example: 1 sellingPartnerCountT360Before: type: integer description: Selling partner count (360 days ago) example: 1 sellingPartnerCountT360Now: type: integer description: Selling partner count (360-day stats) (current) example: 1 sellingPartnerCountT360T90Before: type: integer description: Selling partner count (360-day stats) (90 days ago) example: 1 sellingPartnerCountT360T360Before: type: integer description: Selling partner count (360-day stats) (360 days ago) example: 1 avgPrice: type: number description: Average product price example: 1 avgProductPriceNow: type: number description: Average product price (current) example: 1 avgProductPriceT90Before: type: number description: Average product price (90 days ago) example: 1 avgProductPriceT360Before: type: number description: Average product price (360 days ago) example: 1 minimumPrice: type: number description: Lowest product price example: 1 maximumPrice: type: number description: Highest product price example: 1 searchVolumeWeekly: type: integer description: Search volume (weekly data) example: 1 searchVolumeQuarterly: type: integer description: Search volume (quarterly data) example: 1 searchVolumeGrowthWeekly: type: number description: Search volume growth rate (weekly data) example: 1 searchVolumeGrowthQuarterly: type: number description: Search volume growth rate (quarterly data) example: 1 searchConversionRateWeekly: type: number description: Search conversion rate (weekly data) example: 1 searchConversionRateQuarterly: type: number description: Search conversion rate (quarterly data) example: 1 clickCountWeekly: type: integer description: Click volume (weekly data) example: 1 clickCountQuarterly: type: integer description: Click volume (quarterly data) example: 1 clickConversionRateQuarterly: type: number description: Click conversion rate (quarterly data) example: 1 clickToSaleConversionWeekly: type: number description: Click conversion rate (weekly data) example: 1 unitsSoldWeekly: type: integer description: Sales volume (weekly data) example: 1 unitsSoldQuarterly: type: integer description: Sales volume (quarterly data) example: 1 top5ProductsClickShare: type: number description: Top 5 products click share example: 1 top5ProductsClickShareNow: type: number description: Top 5 products' click share in the niche market (current) example: 1 top5ProductsClickShareT90Before: type: number description: Top 5 products' click share in the niche market (90 days ago) example: 1 top5ProductsClickShareT360Before: type: number description: Top 5 products' click share in the niche market (360 days ago) example: 1 top5ProductsClickShareT360Now: type: number description: Top 5 products click share (360-day stats) (current) example: 1 top5ProductsClickShareT360T90Before: type: number description: Top 5 products click share (360-day stats) (90 days ago) example: 1 top5ProductsClickShareT360T360Before: type: number description: Top 5 products click share (360-day stats) (360 days ago) example: 1 top20ProductsClickShareNow: type: number description: Top 20 products' click share in the niche market (current) example: 1 top20ProductsClickShareT90Before: type: number description: Top 20 products' click share in the niche market (90 days ago) example: 1 top20ProductsClickShareT360Before: type: number description: Top 20 products' click share in the niche market (360 days ago) example: 1 top20ProductsClickShareT360Now: type: number description: Top 20 products click share (360-day stats) (current) example: 1 top20ProductsClickShareT360T90Before: type: number description: Top 20 products click share (360-day stats) (90 days ago) example: 1 top20ProductsClickShareT360T360Before: type: number description: Top 20 products click share (360-day stats) (360 days ago) example: 1 top5BrandsClickShare: type: number description: Top 5 brands' click share in the niche market example: 1 top5BrandsClickShareNow: type: number description: Top 5 brands' click share in the niche market (current) example: 1 top5BrandsClickShareT90Before: type: number description: Top 5 brands' click share in the niche market (90 days ago) example: 1 top5BrandsClickShareT360Before: type: number description: Top 5 brands' click share in the niche market (360 days ago) example: 1 top5BrandsClickShareT360Now: type: number description: Top 5 brands' click share in the niche market (360-day stats) (current) example: 1 top5BrandsClickShareT360T90Before: type: number description: Top 5 brands' click share in the niche market (360-day stats) (90 days ago) example: 1 top5BrandsClickShareT360T360Before: type: number description: Top 5 brands' click share in the niche market (360-day stats) (360 days ago) example: 1 top20BrandsClickShareNow: type: number description: Top 20 brands' click share in the niche market (current) example: 1 top20BrandsClickShareT90Before: type: number description: Top 20 brands' click share in the niche market (90 days ago) example: 1 top20BrandsClickShareT360Before: type: number description: Top 20 brands' click share in the niche market (360 days ago) example: 1 top20BrandsClickShareT360Now: type: number description: Top 20 brands' click share in the niche market (360-day stats) (current) example: 1 top20BrandsClickShareT360T90Before: type: number description: Top 20 brands' click share in the niche market (360-day stats) (90 days ago) example: 1 top20BrandsClickShareT360T360Before: type: number description: Top 20 brands' click share in the niche market (360-day stats) (360 days ago) example: 1 newProductsLaunchedSemiannual: type: integer description: Number of new products launched (semi-annual data) example: 1 newProductsLaunchedT180Now: type: integer description: Number of new products launched (180-day stats) (current) example: 1 newProductsLaunchedT180T90Before: type: integer description: Number of new products launched (180-day stats) (90 days ago) example: 1 newProductsLaunchedT180T360Before: type: integer description: Number of new products launched (180-day stats) (360 days ago) example: 1 newProductsLaunchedT360Now: type: integer description: Number of newly listed products (360-day stats) (current) example: 1 newProductsLaunchedT360T90Before: type: integer description: Number of newly listed products (360-day stats) (90 days ago) example: 1 newProductsLaunchedT360T360Before: type: integer description: Number of newly listed products (360-day stats) (360 days ago) example: 1 successfulLaunchedSemiannual: type: integer description: Number of successfully launched products (semi-annual data) example: 1 launchRateSemiannual: type: number description: Product launch success rate (semi-annual data) example: 1 successfulLaunchesT90Now: type: integer description: Successfully launched count (90-day stats) (current) example: 1 successfulLaunchesT90T90Before: type: integer description: Successfully launched count (90-day stats) (90 days ago) example: 1 successfulLaunchesT90T360Before: type: integer description: Successfully launched count (90-day stats) (360 days ago) example: 1 successfulLaunchesT180Now: type: integer description: Number of successfully launched products (180-day stats) (current) example: 1 successfulLaunchesT180T90Before: type: integer description: Number of successfully launched products (180-day stats) (90 days ago) example: 1 successfulLaunchesT180T360Before: type: integer description: Number of successfully launched products (180-day stats) (360 days ago) example: 1 successfulLaunchesT360Now: type: integer description: Number of successfully launched products (360-day stats) (current) example: 1 successfulLaunchesT360T90Before: type: integer description: Number of successfully launched products (360-day stats) (90 days ago) example: 1 successfulLaunchesT360T360Before: type: integer description: Number of successfully launched products (360-day stats) (360 days ago) example: 1 avgOOSRateNow: type: number description: Average out-of-stock rate (current) example: 1 avgOOSRateT90Before: type: number description: Average out-of-stock rate (90 days ago) example: 1 avgOOSRateT360Before: type: number description: Average out-of-stock rate (360 days ago) example: 1 avgOOSRateT360Now: type: number description: Average out-of-stock rate (360-day stats) (current) example: 1 avgOOSRateT360T90Before: type: number description: Average out-of-stock rate (360-day stats) (90 days ago) example: 1 avgOOSRateT360T360Before: type: number description: Average out-of-stock rate (360-day stats) (360 days ago) example: 1 primeProductsPercentageNow: type: number description: Prime product percentage (current) example: 1 primeProductsPercentageT90Before: type: number description: Prime product percentage (90 days ago) example: 1 primeProductsPercentageT360Before: type: number description: Prime product percentage (360 days ago) example: 1 primeProductsPercentageT360Now: type: number description: Prime product percentage (360-day stats) (current) example: 1 primeProductsPercentageT360T90Before: type: number description: Prime product percentage (360-day stats) (90 days ago) example: 1 primeProductsPercentageT360T360Before: type: number description: Prime product percentage (360-day stats) (360 days ago) example: 1 avgReviewRatingNow: type: number description: Average review rating (current) example: 1 avgReviewRatingT90Before: type: number description: Average review rating (90 days ago) example: 1 avgReviewRatingT360Before: type: number description: Average review rating (360 days ago) example: 1 avgReviewCountNow: type: number description: Average review count (current) example: 1 avgReviewCountT90Before: type: number description: Average review count (90 days ago) example: 1 avgReviewCountT360Before: type: number description: Average review count (360 days ago) example: 1 positiveCustomerReviewInsights: type: array items: {} description: Positive customer review insights example: [] negativeCustomerReviewInsights: type: array items: {} description: Negative customer review insights example: [] productStarRatingImpact: type: array items: {} description: Product star rating impact information example: [] avgBrandAgeNow: type: number description: Average brand age (current) example: 1 avgBrandAgeT90Before: type: number description: Average brand age (90 days ago) example: 1 avgBrandAgeT360Before: type: number description: Average brand age (360 days ago) example: 1 avgBrandAgeQuarterly: type: number description: Average brand age (quarterly data) example: 1 avgBrandAgeT360Now: type: number description: Average brand age (360-day stats) (current) example: 1 avgBrandAgeT360T90Before: type: number description: Average brand age (360-day stats) (90 days ago) example: 1 avgBrandAgeT360T360Before: type: number description: Average brand age (360-day stats) (360 days ago) example: 1 avgSellingPartnerAgeNow: type: number description: Average selling partner age (current) example: 1 avgSellingPartnerAgeT90Before: type: number description: Average selling partner age (90 days ago) example: 1 avgSellingPartnerAgeT360Before: type: number description: Average selling partner age (360 days ago) example: 1 avgBestSellerRankNow: type: number description: Average Best Seller rank (current) example: 1 avgBestSellerRankT90Before: type: number description: Average Best Seller rank (90 days ago) example: 1 avgBestSellerRankT360Before: type: number description: Average Best Seller rank (360 days ago) example: 1 acos: type: number description: (ACOS) Advertising Cost of Sale example: 1 sponsoredProductsPercentageNow: type: number description: Percentage of products with Sponsored Products ads (current) example: 1 sponsoredProductsPercentageT90Before: type: number description: Percentage of products with Sponsored Products ads (90 days ago) example: 1 sponsoredProductsPercentageT360Before: type: number description: Percentage of products with Sponsored Products ads (360 days ago) example: 1 sponsoredProductsPercentageT360Now: type: number description: Percentage of products with Sponsored Products ads (360-day stats) (current) example: 1 sponsoredProductsPercentageT360T90Before: type: number description: Percentage of products with Sponsored Products ads (360-day stats) (90 days ago) example: 1 sponsoredProductsPercentageT360T360Before: type: number description: Percentage of products with Sponsored Products ads (360-day stats) (360 days ago) example: 1 profitMarginGt50PctSkuRatio: type: number description: Proportion of products with profit margin > 50% example: 1 breakEvenRatio: type: number description: Break-even ratio example: 1 returnRateAnnual: type: number description: Return rate (annual data) example: 1 cpc: type: object description: CPC (Cost Per Click) data example: {} properties: {} additionalProperties: true errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. message: type: string description: Provider-specific message. title: type: string description: Provider-specific response title. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. example: total: 1 data: [] columns: [] costToken: 1 nicheId: dfecfecfa9701de73a08867d7bcd3bc0 referenceAsinImageUrl: B072MQ5BRX marketplaceId: US demand: 1 categorieList: [] productCount: 1 productCountNow: 1 productCountT90Before: 1 productCountT360Before: 1 brandCount: 1 brandCountNow: 1 brandCountT90Before: 1 brandCountT360Before: 1 brandCountT360Now: 1 brandCountT360T90Before: 1 brandCountT360T360Before: 1 sellingPartnerCountNow: 1 sellingPartnerCountT90Before: 1 sellingPartnerCountT360Before: 1 sellingPartnerCountT360Now: 1 sellingPartnerCountT360T90Before: 1 sellingPartnerCountT360T360Before: 1 avgPrice: 1 avgProductPriceNow: 1 avgProductPriceT90Before: 1 avgProductPriceT360Before: 1 minimumPrice: 1 maximumPrice: 1 searchVolumeWeekly: 1 searchVolumeQuarterly: 1 searchVolumeGrowthWeekly: 1 searchVolumeGrowthQuarterly: 1 searchConversionRateWeekly: 1 searchConversionRateQuarterly: 1 clickCountWeekly: 1 clickCountQuarterly: 1 clickConversionRateQuarterly: 1 clickToSaleConversionWeekly: 1 unitsSoldWeekly: 1 unitsSoldQuarterly: 1 top5ProductsClickShare: 1 top5ProductsClickShareNow: 1 top5ProductsClickShareT90Before: 1 top5ProductsClickShareT360Before: 1 top5ProductsClickShareT360Now: 1 top5ProductsClickShareT360T90Before: 1 top5ProductsClickShareT360T360Before: 1 top20ProductsClickShareNow: 1 top20ProductsClickShareT90Before: 1 top20ProductsClickShareT360Before: 1 top20ProductsClickShareT360Now: 1 top20ProductsClickShareT360T90Before: 1 top20ProductsClickShareT360T360Before: 1 top5BrandsClickShare: 1 top5BrandsClickShareNow: 1 top5BrandsClickShareT90Before: 1 top5BrandsClickShareT360Before: 1 top5BrandsClickShareT360Now: 1 top5BrandsClickShareT360T90Before: 1 top5BrandsClickShareT360T360Before: 1 top20BrandsClickShareNow: 1 top20BrandsClickShareT90Before: 1 top20BrandsClickShareT360Before: 1 top20BrandsClickShareT360Now: 1 top20BrandsClickShareT360T90Before: 1 top20BrandsClickShareT360T360Before: 1 newProductsLaunchedSemiannual: 1 newProductsLaunchedT180Now: 1 newProductsLaunchedT180T90Before: 1 newProductsLaunchedT180T360Before: 1 newProductsLaunchedT360Now: 1 newProductsLaunchedT360T90Before: 1 newProductsLaunchedT360T360Before: 1 successfulLaunchedSemiannual: 1 launchRateSemiannual: 1 successfulLaunchesT90Now: 1 successfulLaunchesT90T90Before: 1 successfulLaunchesT90T360Before: 1 successfulLaunchesT180Now: 1 successfulLaunchesT180T90Before: 1 successfulLaunchesT180T360Before: 1 successfulLaunchesT360Now: 1 successfulLaunchesT360T90Before: 1 successfulLaunchesT360T360Before: 1 avgOOSRateNow: 1 avgOOSRateT90Before: 1 avgOOSRateT360Before: 1 avgOOSRateT360Now: 1 avgOOSRateT360T90Before: 1 avgOOSRateT360T360Before: 1 primeProductsPercentageNow: 1 primeProductsPercentageT90Before: 1 primeProductsPercentageT360Before: 1 primeProductsPercentageT360Now: 1 primeProductsPercentageT360T90Before: 1 primeProductsPercentageT360T360Before: 1 avgReviewRatingNow: 1 avgReviewRatingT90Before: 1 avgReviewRatingT360Before: 1 avgReviewCountNow: 1 avgReviewCountT90Before: 1 avgReviewCountT360Before: 1 positiveCustomerReviewInsights: [] negativeCustomerReviewInsights: [] productStarRatingImpact: [] avgBrandAgeNow: 1 avgBrandAgeT90Before: 1 avgBrandAgeT360Before: 1 avgBrandAgeQuarterly: 1 avgBrandAgeT360Now: 1 avgBrandAgeT360T90Before: 1 avgBrandAgeT360T360Before: 1 avgSellingPartnerAgeNow: 1 avgSellingPartnerAgeT90Before: 1 avgSellingPartnerAgeT360Before: 1 avgBestSellerRankNow: 1 avgBestSellerRankT90Before: 1 avgBestSellerRankT360Before: 1 acos: 1 sponsoredProductsPercentageNow: 1 sponsoredProductsPercentageT90Before: 1 sponsoredProductsPercentageT360Before: 1 sponsoredProductsPercentageT360Now: 1 sponsoredProductsPercentageT360T90Before: 1 sponsoredProductsPercentageT360T360Before: 1 profitMarginGt50PctSkuRatio: 1 breakEvenRatio: 1 returnRateAnnual: 1 cpc: {} additionalProperties: true example: total: 1 data: [] columns: [] costToken: 1 nicheId: dfecfecfa9701de73a08867d7bcd3bc0 referenceAsinImageUrl: B072MQ5BRX marketplaceId: US demand: 1 categorieList: [] productCount: 1 productCountNow: 1 productCountT90Before: 1 productCountT360Before: 1 brandCount: 1 brandCountNow: 1 brandCountT90Before: 1 brandCountT360Before: 1 brandCountT360Now: 1 brandCountT360T90Before: 1 brandCountT360T360Before: 1 sellingPartnerCountNow: 1 sellingPartnerCountT90Before: 1 sellingPartnerCountT360Before: 1 sellingPartnerCountT360Now: 1 sellingPartnerCountT360T90Before: 1 sellingPartnerCountT360T360Before: 1 avgPrice: 1 avgProductPriceNow: 1 avgProductPriceT90Before: 1 avgProductPriceT360Before: 1 minimumPrice: 1 maximumPrice: 1 searchVolumeWeekly: 1 searchVolumeQuarterly: 1 searchVolumeGrowthWeekly: 1 searchVolumeGrowthQuarterly: 1 searchConversionRateWeekly: 1 searchConversionRateQuarterly: 1 clickCountWeekly: 1 clickCountQuarterly: 1 clickConversionRateQuarterly: 1 clickToSaleConversionWeekly: 1 unitsSoldWeekly: 1 unitsSoldQuarterly: 1 top5ProductsClickShare: 1 top5ProductsClickShareNow: 1 top5ProductsClickShareT90Before: 1 top5ProductsClickShareT360Before: 1 top5ProductsClickShareT360Now: 1 top5ProductsClickShareT360T90Before: 1 top5ProductsClickShareT360T360Before: 1 top20ProductsClickShareNow: 1 top20ProductsClickShareT90Before: 1 top20ProductsClickShareT360Before: 1 top20ProductsClickShareT360Now: 1 top20ProductsClickShareT360T90Before: 1 top20ProductsClickShareT360T360Before: 1 top5BrandsClickShare: 1 top5BrandsClickShareNow: 1 top5BrandsClickShareT90Before: 1 top5BrandsClickShareT360Before: 1 top5BrandsClickShareT360Now: 1 top5BrandsClickShareT360T90Before: 1 top5BrandsClickShareT360T360Before: 1 top20BrandsClickShareNow: 1 top20BrandsClickShareT90Before: 1 top20BrandsClickShareT360Before: 1 top20BrandsClickShareT360Now: 1 top20BrandsClickShareT360T90Before: 1 top20BrandsClickShareT360T360Before: 1 newProductsLaunchedSemiannual: 1 newProductsLaunchedT180Now: 1 newProductsLaunchedT180T90Before: 1 newProductsLaunchedT180T360Before: 1 newProductsLaunchedT360Now: 1 newProductsLaunchedT360T90Before: 1 newProductsLaunchedT360T360Before: 1 successfulLaunchedSemiannual: 1 launchRateSemiannual: 1 successfulLaunchesT90Now: 1 successfulLaunchesT90T90Before: 1 successfulLaunchesT90T360Before: 1 successfulLaunchesT180Now: 1 successfulLaunchesT180T90Before: 1 successfulLaunchesT180T360Before: 1 successfulLaunchesT360Now: 1 successfulLaunchesT360T90Before: 1 successfulLaunchesT360T360Before: 1 avgOOSRateNow: 1 avgOOSRateT90Before: 1 avgOOSRateT360Before: 1 avgOOSRateT360Now: 1 avgOOSRateT360T90Before: 1 avgOOSRateT360T360Before: 1 primeProductsPercentageNow: 1 primeProductsPercentageT90Before: 1 primeProductsPercentageT360Before: 1 primeProductsPercentageT360Now: 1 primeProductsPercentageT360T90Before: 1 primeProductsPercentageT360T360Before: 1 avgReviewRatingNow: 1 avgReviewRatingT90Before: 1 avgReviewRatingT360Before: 1 avgReviewCountNow: 1 avgReviewCountT90Before: 1 avgReviewCountT360Before: 1 positiveCustomerReviewInsights: [] negativeCustomerReviewInsights: [] productStarRatingImpact: [] avgBrandAgeNow: 1 avgBrandAgeT90Before: 1 avgBrandAgeT360Before: 1 avgBrandAgeQuarterly: 1 avgBrandAgeT360Now: 1 avgBrandAgeT360T90Before: 1 avgBrandAgeT360T360Before: 1 avgSellingPartnerAgeNow: 1 avgSellingPartnerAgeT90Before: 1 avgSellingPartnerAgeT360Before: 1 avgBestSellerRankNow: 1 avgBestSellerRankT90Before: 1 avgBestSellerRankT360Before: 1 acos: 1 sponsoredProductsPercentageNow: 1 sponsoredProductsPercentageT90Before: 1 sponsoredProductsPercentageT360Before: 1 sponsoredProductsPercentageT360Now: 1 sponsoredProductsPercentageT360T90Before: 1 sponsoredProductsPercentageT360T360Before: 1 profitMarginGt50PctSkuRatio: 1 breakEvenRatio: 1 returnRateAnnual: 1 cpc: {} '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: amazon-niche-info x-nexscope-mcp-tool-name: nexscope_amazon_niche_info x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/amazon-niche-info-by-asin/run: post: tags: - Amazon Marketplace Intelligence summary: Amazon Niche Info By Asin description: Deep analysis of Amazon niche markets by product ASIN, covering monopoly level, brand concentration, new product success rate, and market opportunity score. operationId: runAmazonNicheInfoByAsin externalDocs: description: Amazon Niche Info By Asin documentation url: https://www.nexscope.ai/api-docs/amazon-niche-info-by-asin requestBody: required: true content: application/json: schema: type: object description: Request parameters documented by ecommerce.amazon-niche-info-by-asin. properties: asin: type: string description: Product ASIN (required). The tool will find market segments that share the same niche as this ASIN example: B072MQ5BRX countryCode: type: string description: 'Country code, options: US (United States), JP (Japan), DE (Germany)' count: type: integer description: Number of niche markets returned example: 1 productCountMin: type: integer description: Minimum product count (current) example: 1 productCountMax: type: integer description: Maximum product count (current) example: 1 avgPriceMin: type: number description: Minimum average price (current) example: 1 avgPriceMax: type: number description: Maximum average price (current) example: 1 searchVolumeT7Min: type: integer description: Minimum search volume (7-day stats) example: 1 searchVolumeT7Max: type: integer description: Maximum search volume (7-day stats) example: 1 unitsSoldT7Min: type: integer description: Minimum sales volume (7-day stats) example: 1 unitsSoldT7Max: type: integer description: Maximum sales volume (7-day stats) example: 1 clickCountT7Min: type: integer description: Minimum click volume (7-day stats) example: 1 clickCountT7Max: type: integer description: Maximum click volume (7-day stats) example: 1 clickConversionRateT7Min: type: number description: Minimum click conversion rate (7-day stats), range 0-1, 0.1 means 10% conversion rate example: 1 clickConversionRateT7Max: type: number description: Maximum click conversion rate (7-day stats), range 0-1, 0.1 means 10% conversion rate example: 1 brandCountMin: type: integer description: Minimum brand count example: 1 brandCountMax: type: integer description: Maximum brand count example: 1 top5BrandsClickShareMin: type: number description: Minimum top 5 brands' click share in the niche market, range 0-1, 0.1 means 10% click share example: 1 top5BrandsClickShareMax: type: number description: Maximum top 5 brands' click share in the niche market, range 0-1, 0.1 means 10% click share example: 1 avgBrandAgeMin: type: number description: Minimum average brand age (current) example: 1 avgBrandAgeMax: type: number description: Maximum average brand age (current) example: 1 avgBrandAgeQoqMin: type: number description: Minimum average brand age (90-day stats) example: 1 avgBrandAgeQoqMax: type: number description: Maximum average brand age (90-day stats) example: 1 avgBrandAgeYoyMin: type: number description: Minimum average brand age (360-day stats) example: 1 avgBrandAgeYoyMax: type: number description: Maximum average brand age (360-day stats) example: 1 avgSellingPartnerAgeMin: type: number description: Minimum average selling partner age example: 1 avgSellingPartnerAgeMax: type: number description: Maximum average selling partner age example: 1 avgSellingPartnerAgeQoqMin: type: number description: Minimum average selling partner age (90-day stats) example: 1 avgSellingPartnerAgeQoqMax: type: number description: Maximum average selling partner age (90-day stats) example: 1 avgSellingPartnerAgeYoyMin: type: number description: Minimum average selling partner age (360-day stats) example: 1 avgSellingPartnerAgeYoyMax: type: number description: Maximum average selling partner age (360-day stats) example: 1 top5ProductsClickShareMin: type: number description: Minimum top 5 products click share (current), range 0-1, 0.1 means 10% click share example: 1 top5ProductsClickShareMax: type: number description: Maximum top 5 products click share (current), range 0-1, 0.1 means 10% click share example: 1 sponsoredProductsPercentageMin: type: number description: Minimum SP ad share, range 0-1, 0.1 means 10% example: 1 sponsoredProductsPercentageMax: type: number description: Maximum SP ad share, range 0-1, 0.1 means 10% example: 1 cpcMediumMin: type: number description: Minimum CPC (current) example: 1 cpcMediumMax: type: number description: Maximum CPC (current) example: 1 launchRateT180Min: type: number description: Minimum product launch success rate (180-day stats), range 0-1, 0.1 means 10% success rate example: 1 launchRateT180Max: type: number description: Maximum product launch success rate (180-day stats), range 0-1, 0.1 means 10% success rate example: 1 returnRateT360Min: type: number description: Minimum return rate (360-day stats), range 0-1, 0.1 means 10% return rate example: 1 returnRateT360Max: type: number description: Maximum return rate (360-day stats), range 0-1, 0.1 means 10% return rate example: 1 required: - asin example: countryCode: US count: 10 asin: B072MQ5BRX additionalProperties: true example: countryCode: US count: 10 asin: B072MQ5BRX responses: '200': description: Successful response. content: application/json: schema: type: object description: Returns the documented upstream API response directly without an additional wrapper. properties: errcode: type: integer description: Business status code, 200 indicates success example: 1 costToken: type: integer description: Tokens consumed example: 1 nicheInfoVoList: type: array items: type: object properties: nicheId: type: string description: Niche market ID example: example-id nicheTitle: type: string description: Niche market title translationZh: type: string description: Niche market title (Chinese) demand: type: integer description: Niche market score example: 1 productCount: type: integer description: Product count example: 1 avgPrice: type: number description: Average product price example: 1 minimumPrice: type: number description: Lowest product price example: 1 maximumPrice: type: number description: Highest product price example: 1 searchVolumeWeekly: type: integer description: Search volume (weekly data) example: 1 searchVolumeQuarterly: type: integer description: Search volume (quarterly data) example: 1 searchVolumeGrowthWeekly: type: number description: Search volume growth rate (weekly data) example: 1 searchVolumeGrowthQuarterly: type: number description: Search volume growth rate (quarterly data) example: 1 unitsSoldWeekly: type: integer description: Sales volume (weekly data) example: 1 unitsSoldQuarterly: type: integer description: Sales volume (quarterly data) example: 1 clickCountWeekly: type: integer description: Click volume (weekly data) example: 1 clickCountQuarterly: type: integer description: Click volume (quarterly data) example: 1 clickToSaleConversionWeekly: type: number description: Click conversion rate (weekly data) example: 1 clickConversionRateQuarterly: type: number description: Click conversion rate (quarterly data) example: 1 searchConversionRateWeekly: type: number description: Search conversion rate (weekly data) example: 1 searchConversionRateQuarterly: type: number description: Search conversion rate (quarterly data) example: 1 brandCount: type: integer description: Brand count example: 1 top5BrandsClickShare: type: number description: Top 5 brands' click share in the niche market example: 1 top5ProductsClickShare: type: number description: Top 5 products click share example: 1 avgBrandAgeNow: type: number description: Average brand age (current) example: 1 avgBrandAgeQuarterly: type: number description: Average brand age (quarterly data) example: 1 newProductsLaunchedSemiannual: type: integer description: Number of new products launched (semi-annual data) example: 1 successfulLaunchedSemiannual: type: integer description: Number of successfully launched products (semi-annual data) example: 1 launchRateSemiannual: type: number description: Product launch success rate (semi-annual data) example: 1 returnRateAnnual: type: number description: Return rate (annual data) example: 1 acos: type: number description: (ACOS) Advertising Cost of Sale example: 1 profitMarginGt50PctSkuRatio: type: number description: Proportion of products with profit margin > 50% example: 1 breakEvenRatio: type: number description: Break-even natural share example: 1 cpc: type: object description: 'CPC data: { high (maximum bid), medium (median bid), low (minimum bid) }' example: {} properties: {} additionalProperties: true categorieList: type: array items: {} description: Product category list example: [] referenceAsinImageUrl: type: string description: Niche market reference image URL example: B072MQ5BRX additionalProperties: true description: Niche market information list (see niche market object fields below) example: [] errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. message: type: string description: Provider-specific message. type: type: string description: Provider-specific render or payload type. title: type: string description: Provider-specific response title. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. example: errcode: 1 costToken: 1 nicheInfoVoList: - nicheId: example-id demand: 1 productCount: 1 avgPrice: 1 minimumPrice: 1 maximumPrice: 1 searchVolumeWeekly: 1 searchVolumeQuarterly: 1 searchVolumeGrowthWeekly: 1 searchVolumeGrowthQuarterly: 1 unitsSoldWeekly: 1 unitsSoldQuarterly: 1 clickCountWeekly: 1 clickCountQuarterly: 1 clickToSaleConversionWeekly: 1 clickConversionRateQuarterly: 1 searchConversionRateWeekly: 1 searchConversionRateQuarterly: 1 brandCount: 1 top5BrandsClickShare: 1 top5ProductsClickShare: 1 avgBrandAgeNow: 1 avgBrandAgeQuarterly: 1 newProductsLaunchedSemiannual: 1 successfulLaunchedSemiannual: 1 launchRateSemiannual: 1 returnRateAnnual: 1 acos: 1 profitMarginGt50PctSkuRatio: 1 breakEvenRatio: 1 cpc: {} categorieList: [] referenceAsinImageUrl: B072MQ5BRX additionalProperties: true example: errcode: 1 costToken: 1 nicheInfoVoList: - nicheId: example-id demand: 1 productCount: 1 avgPrice: 1 minimumPrice: 1 maximumPrice: 1 searchVolumeWeekly: 1 searchVolumeQuarterly: 1 searchVolumeGrowthWeekly: 1 searchVolumeGrowthQuarterly: 1 unitsSoldWeekly: 1 unitsSoldQuarterly: 1 clickCountWeekly: 1 clickCountQuarterly: 1 clickToSaleConversionWeekly: 1 clickConversionRateQuarterly: 1 searchConversionRateWeekly: 1 searchConversionRateQuarterly: 1 brandCount: 1 top5BrandsClickShare: 1 top5ProductsClickShare: 1 avgBrandAgeNow: 1 avgBrandAgeQuarterly: 1 newProductsLaunchedSemiannual: 1 successfulLaunchedSemiannual: 1 launchRateSemiannual: 1 returnRateAnnual: 1 acos: 1 profitMarginGt50PctSkuRatio: 1 breakEvenRatio: 1 cpc: {} categorieList: [] referenceAsinImageUrl: B072MQ5BRX '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: amazon-niche-info-by-asin x-nexscope-mcp-tool-name: nexscope_amazon_niche_info_by_asin x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/amazon-opportunity-search-by-metrics/run: post: tags: - Amazon Marketplace Intelligence summary: Amazon Opportunity Search By Metrics description: 'Amazon reverse product selection: filter Amazon niches and keywords by 30+ business dimensions (market size & growth, price tiers & share, competition density & top concentration, demographics such as age/gender/income, review highlights & pain points) from a metrics pool aggregated from historical business insight reports.' operationId: runAmazonOpportunitySearchByMetrics externalDocs: description: Amazon Opportunity Search By Metrics documentation url: https://www.nexscope.ai/api-docs/amazon-opportunity-search-by-metrics requestBody: required: true content: application/json: schema: type: object description: Request parameters documented by ecommerce.amazon-opportunity-search-by-metrics. properties: amazonDomain: type: string description: Amazon site code (closed enum), currently only supports US. Defaults to US only if not specified limit: type: integer description: Maximum number of results to return (1-200), default 25. No page parameter; returns the most recent N records sorted by collection time descending example: 1 keyword: type: string description: Search keyword text fragment (LIKE fuzzy match) example: phone case nicheName: type: string description: Normalized niche name fragment (LIKE, snake_case lowercase), suitable for niche time-series comparison nicheRevenue360dMinUsdAtLeastGte: type: number description: Minimum 360-day market revenue lower bound (USD) example: 1 nicheRevenue360dMinUsdAtLeastLte: type: number description: Maximum 360-day market revenue lower bound (USD) example: 1 nicheRevenue360dMaxUsdAtLeastGte: type: number description: Minimum 360-day market revenue upper bound (USD) example: 1 nicheRevenue360dMaxUsdAtLeastLte: type: number description: Maximum 360-day market revenue upper bound (USD) example: 1 nichePeakSearchVolumeAtLeastGte: type: integer description: Peak monthly search volume minimum (non-negative integer) example: 1 nichePeakSearchVolumeAtLeastLte: type: integer description: Peak monthly search volume maximum (non-negative integer) example: 1 nicheSearchVolumeYoyChangePctAtLeastGte: type: number description: Search volume YoY change rate minimum (%, signed) example: 1 nicheSearchVolumeYoyChangePctAtLeastLte: type: number description: Search volume YoY change rate maximum (%, signed) example: 1 nichePeakMonthGte: type: integer description: Search peak month minimum (1-12) example: 1 nichePeakMonthLte: type: integer description: Search peak month maximum (1-12) example: 1 nicheBrandCountGte: type: integer description: Active brand count minimum example: 1 nicheBrandCountLte: type: integer description: Active brand count maximum example: 1 nicheBrandCountYoyChangePctAtLeastGte: type: number description: Brand count YoY change rate minimum (%, signed) example: 1 nicheBrandCountYoyChangePctAtLeastLte: type: number description: Brand count YoY change rate maximum (%, signed) example: 1 nicheTop5ProductClickSharePctAtLeastGte: type: number description: Top 5 product click share minimum (0-100) example: 1 nicheTop5ProductClickSharePctAtLeastLte: type: number description: Top 5 product click share maximum (0-100) example: 1 featureTop5BrandSharePctAtLeastGte: type: number description: Top 5 brand combined share minimum (0-100) example: 1 featureTop5BrandSharePctAtLeastLte: type: number description: Top 5 brand combined share maximum (0-100) example: 1 featureTopBrandsContains: type: string description: Top 3 brand name fragment (original text LIKE, case-sensitive) priceMinUsdGte: type: number description: Niche minimum product price lower bound (USD) example: 1 priceMinUsdLte: type: number description: Niche minimum product price upper bound (USD) example: 1 priceMaxUsdGte: type: number description: Niche maximum product price lower bound (USD) example: 1 priceMaxUsdLte: type: number description: Niche maximum product price upper bound (USD) example: 1 priceSweetSpotMinUsdGte: type: number description: Sweet spot lower bound minimum (USD) example: 1 priceSweetSpotMinUsdLte: type: number description: Sweet spot lower bound maximum (USD) example: 1 priceSweetSpotMaxUsdGte: type: number description: Sweet spot upper bound minimum (USD) example: 1 priceSweetSpotMaxUsdLte: type: number description: Sweet spot upper bound maximum (USD) example: 1 priceEntryClickSharePctAtLeastGte: type: number description: Entry tier click share minimum (0-100) example: 1 priceEntryClickSharePctAtLeastLte: type: number description: Entry tier click share maximum (0-100) example: 1 priceMidClickSharePctAtLeastGte: type: number description: Mid tier click share minimum (0-100) example: 1 priceMidClickSharePctAtLeastLte: type: number description: Mid tier click share maximum (0-100) example: 1 priceHighClickSharePctAtLeastGte: type: number description: High tier click share minimum (0-100) example: 1 priceHighClickSharePctAtLeastLte: type: number description: High tier click share maximum (0-100) example: 1 demoPrimaryAgeMinGte: type: integer description: Primary audience age lower bound minimum (0-120 years) example: 1 demoPrimaryAgeMinLte: type: integer description: Primary audience age lower bound maximum (0-120 years) example: 1 demoPrimaryAgeMaxGte: type: integer description: Primary audience age upper bound minimum (0-120 years) example: 1 demoPrimaryAgeMaxLte: type: integer description: Primary audience age upper bound maximum (0-120 years) example: 1 demoGenderDominant: type: string description: 'Dominant gender (closed enum): female / male / mixed / unspecified' demoPrimaryIncomeTier: type: string description: 'Income tier (closed enum): low / middle_low / middle / middle_upper / upper_middle / high' demoLifeStageTagsContains: type: string description: 'Life stage tag fragment (snake_case, LIKE): parent, student, retiree, athlete, etc.' featureNewAvgReviewCountAtLeastGte: type: integer description: New product average review count minimum (non-negative integer) example: 1 featureNewAvgReviewCountAtLeastLte: type: integer description: New product average review count maximum (non-negative integer) example: 1 featureEstablishedAvgReviewCountAtLeastGte: type: integer description: Established product average review count minimum (non-negative integer) example: 1 featureEstablishedAvgReviewCountAtLeastLte: type: integer description: Established product average review count maximum (non-negative integer) example: 1 featureEmergingTrendTagsContains: type: string description: 'Emerging trend feature tag fragment (snake_case, LIKE): cordless, portable, smart, etc.' featureUncommonFeatureTagsContains: type: string description: 'Rare differentiation feature tag fragment (snake_case, LIKE): hema_free, medical_grade_silicone, etc.' searchTopCategory1Label: type: string description: 'Search traffic top category 1 label fragment (snake_case, LIKE): core_product_terms, set_kit_configurations, etc.' reviewPositiveTop1Topic: type: string description: 'Positive review #1 topic fragment (snake_case, LIKE): comfort, quality_overall_generic, etc.' reviewPositiveTop1PctAtLeastGte: type: number description: 'Positive review #1 topic share minimum (0-100, share among positive reviews)' example: 1 reviewPositiveTop1PctAtLeastLte: type: number description: 'Positive review #1 topic share maximum (0-100)' example: 1 reviewNegativeTop1Topic: type: string description: 'Negative review #1 topic fragment (snake_case, LIKE): size, quality, durability, etc.' reviewNegativeTop1PctAtLeastGte: type: number description: 'Negative review #1 topic share minimum (0-100, share among negative reviews)' example: 1 reviewNegativeTop1PctAtLeastLte: type: number description: 'Negative review #1 topic share maximum (0-100)' example: 1 reviewNegativeTop2Topic: type: string description: 'Negative review #2 topic fragment (snake_case, LIKE)' reviewStrategicInsightTagsContains: type: string description: 'Review strategic insight tag fragment (snake_case, LIKE): sizing_clarity, material_transparency, etc.' example: limit: 10 keyword: phone case amazonDomain: US additionalProperties: true example: limit: 10 keyword: phone case amazonDomain: US responses: '200': description: Successful response. content: application/json: schema: type: object description: Returns the documented upstream API response directly without an additional wrapper. properties: code: type: string description: Response code, 200 indicates success msg: type: string description: Message, ok on success, error description on failure data: type: array items: type: object properties: amazonDomain: type: string description: Site code (currently fixed US) nicheName: type: string description: Normalized niche name (snake_case) demoGenderDominant: type: string description: Dominant gender (female / male / mixed / unspecified) demoPrimaryIncomeTier: type: string description: Core audience income tier searchTopCategory1Label: type: string description: Traffic top category 1 normalized label description: Array of keyword metric records, each corresponding to a (site, keyword) combination, approximately 37 fields, sorted by collection time descending example: [] keyword: type: string description: Original search keyword example: phone case nicheRevenue360dMinUsdAtLeast/nicheRevenue360dMaxUsdAtLeast: type: number description: Last 360 days market revenue lower bound / upper bound (USD) example: 1 nichePeakSearchVolumeAtLeast: type: integer description: Peak monthly search volume example: 1 nichePeakMonth: type: integer description: Search peak month (1-12) example: 1 nicheSearchVolumeYoyChangePctAtLeast: type: number description: Search volume YoY change rate (%, signed) example: 1 nicheBrandCount/nicheBrandCountYoyChangePctAtLeast: type: integer description: Active brand count and its YoY change rate example: 1 nicheTop5ProductClickSharePctAtLeast: type: number description: Top 5 product click share (0-100) example: 1 featureTop5BrandSharePctAtLeast: type: number description: Top 5 brand combined share (0-100) example: 1 featureTopBrands: type: array items: {} description: Top 3 brand name list (original text) example: [] priceMinUsd/priceMaxUsd: type: number description: Niche overall minimum / maximum product price example: 1 priceSweetSpotMinUsd/priceSweetSpotMaxUsd: type: number description: Value sweet spot price range lower bound / upper bound example: 1 priceEntryClickSharePctAtLeast/priceMidClickSharePctAtLeast/priceHighClickSharePctAtLeast: type: number description: Entry / Mid / High tier click share (0-100) example: 1 demoPrimaryAgeMin/demoPrimaryAgeMax: type: integer description: Core audience age lower bound / upper bound example: 1 demoLifeStageTags: type: array items: {} description: Life stage tag list example: [] featureNewAvgReviewCountAtLeast/featureEstablishedAvgReviewCountAtLeast: type: integer description: New / Established product average review count example: 1 featureEmergingTrendTags/featureUncommonFeatureTags: type: array items: {} description: Emerging trend / Rare differentiation feature tags example: [] reviewPositiveTop1Topic/reviewPositiveTop1PctAtLeast: type: number description: 'Positive review #1 topic and its share among positive reviews' example: 1 reviewNegativeTop1Topic/reviewNegativeTop1PctAtLeast/reviewNegativeTop2Topic: type: number description: 'Negative review #1 topic, share, and secondary cause' example: 1 reviewStrategicInsightTags: type: array items: {} description: Review strategic insight tags example: [] errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. message: type: string description: Provider-specific message. type: type: string description: Provider-specific render or payload type. title: type: string description: Provider-specific response title. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. costToken: type: integer description: Token cost reported by the upstream provider. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. example: data: [] keyword: phone case nicheRevenue360dMinUsdAtLeast/nicheRevenue360dMaxUsdAtLeast: 1 nichePeakSearchVolumeAtLeast: 1 nichePeakMonth: 1 nicheSearchVolumeYoyChangePctAtLeast: 1 nicheBrandCount/nicheBrandCountYoyChangePctAtLeast: 1 nicheTop5ProductClickSharePctAtLeast: 1 featureTop5BrandSharePctAtLeast: 1 featureTopBrands: [] priceMinUsd/priceMaxUsd: 1 priceSweetSpotMinUsd/priceSweetSpotMaxUsd: 1 priceEntryClickSharePctAtLeast/priceMidClickSharePctAtLeast/priceHighClickSharePctAtLeast: 1 demoPrimaryAgeMin/demoPrimaryAgeMax: 1 demoLifeStageTags: [] featureNewAvgReviewCountAtLeast/featureEstablishedAvgReviewCountAtLeast: 1 featureEmergingTrendTags/featureUncommonFeatureTags: [] reviewPositiveTop1Topic/reviewPositiveTop1PctAtLeast: 1 reviewNegativeTop1Topic/reviewNegativeTop1PctAtLeast/reviewNegativeTop2Topic: 1 reviewStrategicInsightTags: [] additionalProperties: true example: data: [] keyword: phone case nicheRevenue360dMinUsdAtLeast/nicheRevenue360dMaxUsdAtLeast: 1 nichePeakSearchVolumeAtLeast: 1 nichePeakMonth: 1 nicheSearchVolumeYoyChangePctAtLeast: 1 nicheBrandCount/nicheBrandCountYoyChangePctAtLeast: 1 nicheTop5ProductClickSharePctAtLeast: 1 featureTop5BrandSharePctAtLeast: 1 featureTopBrands: [] priceMinUsd/priceMaxUsd: 1 priceSweetSpotMinUsd/priceSweetSpotMaxUsd: 1 priceEntryClickSharePctAtLeast/priceMidClickSharePctAtLeast/priceHighClickSharePctAtLeast: 1 demoPrimaryAgeMin/demoPrimaryAgeMax: 1 demoLifeStageTags: [] featureNewAvgReviewCountAtLeast/featureEstablishedAvgReviewCountAtLeast: 1 featureEmergingTrendTags/featureUncommonFeatureTags: [] reviewPositiveTop1Topic/reviewPositiveTop1PctAtLeast: 1 reviewNegativeTop1Topic/reviewNegativeTop1PctAtLeast/reviewNegativeTop2Topic: 1 reviewStrategicInsightTags: [] '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: amazon-opportunity-search-by-metrics x-nexscope-mcp-tool-name: nexscope_amazon_opportunity_search_by_metrics x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/amazon-policy-feed/run: post: tags: - Amazon Marketplace Intelligence summary: Amazon Policy Feed description: Query Amazon is latest policy, regulation, and compliance feed. Supports paginated browsing by marketplace and time range (with AI-generated Chinese summaries), and fetching full article body by record ID. operationId: runAmazonPolicyFeed externalDocs: description: Amazon Policy Feed documentation url: https://www.nexscope.ai/api-docs/amazon-policy-feed requestBody: required: true content: application/json: schema: type: object description: Request parameters documented by ecommerce.amazon-policy-feed. properties: site: type: string description: Amazon site code, uppercase. Defaults to US. example: US publishedAtGte: type: string description: Publication or change time lower bound, inclusive, format yyyy-MM-dd HH:mm:ss. example: '2026-01-01 00:00:00' publishedAtLte: type: string description: Publication or change time upper bound, inclusive, format yyyy-MM-dd HH:mm:ss. example: '2026-01-07 23:59:59' page: type: integer description: Page number, starting from 1. example: 1 pageSize: type: integer description: Items per page, range 1-100. example: 20 id: type: string description: News record ID from data[].id. Required when calling the policy detail endpoint. example: a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4 example: site: US pageSize: 20 page: 1 additionalProperties: true example: site: US pageSize: 20 page: 1 responses: '200': description: Successful response. content: application/json: schema: type: object description: Returns the documented upstream API response directly without an additional wrapper. properties: errcode: type: integer description: Gateway response code, 200 indicates success. example: 200 errmsg: type: string description: Gateway status or error message. example: ok code: type: string description: Business response code for the list endpoint. example: '200' msg: type: string description: Business message for the list endpoint. example: ok total: type: integer description: Number of news items returned by the list endpoint. example: 1 type: type: string description: Render style returned by the upstream endpoint. example: tableListWorkbenches data: type: array items: type: object properties: id: type: string description: News record ID used to fetch the full body. example: a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4 title: type: string description: News title in the list response. example: Amazon policy update summaryZh: type: string description: AI-generated Chinese summary for the news item. example: Policy summary originalUrl: type: string description: Original article URL. example: https://example.com/news publishedAt: type: string description: Publication or change time, format yyyy-MM-dd HH:mm:ss. example: '2026-01-01 00:00:00' additionalProperties: true description: News list returned by the policy feed endpoint. example: [] stdout: type: string description: Full news body in Markdown format returned by the detail endpoint. example: '# Amazon policy update' title: type: string description: News title returned by the detail endpoint. example: Amazon policy update summaryZh: type: string description: AI-generated Chinese summary returned by the detail endpoint. example: Policy summary costTime: type: integer description: Total processing time in milliseconds. example: 1 costToken: type: integer description: Token consumption. example: 1 columns: type: array items: {} description: Frontend column definitions returned by the list endpoint. example: [] message: type: string description: Provider-specific message. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. example: errcode: 200 errmsg: ok code: '200' msg: ok total: 1 type: tableListWorkbenches data: - id: a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4 title: Amazon policy update summaryZh: Policy summary originalUrl: https://example.com/news publishedAt: '2026-01-01 00:00:00' stdout: '# Amazon policy update' title: Amazon policy update summaryZh: Policy summary costTime: 1 costToken: 1 columns: [] additionalProperties: true example: errcode: 200 errmsg: ok code: '200' msg: ok total: 1 type: tableListWorkbenches data: - id: a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4 title: Amazon policy update summaryZh: Policy summary originalUrl: https://example.com/news publishedAt: '2026-01-01 00:00:00' stdout: '# Amazon policy update' title: Amazon policy update summaryZh: Policy summary costTime: 1 costToken: 1 columns: [] '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: amazon-policy-feed x-nexscope-mcp-tool-name: nexscope_amazon_policy_feed x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/amazon-product-database/run: post: tags: - Amazon Marketplace Intelligence summary: Amazon Product Database description: Jungle Scout Product Database multi-condition filtering. Filter Amazon products by category, price, sales volume, revenue, reviews, rating, weight, BSR rank, LQS, seller type, and more across 10 marketplaces. operationId: runAmazonProductDatabase externalDocs: description: Amazon Product Database documentation url: https://www.nexscope.ai/api-docs/amazon-product-database requestBody: required: true content: application/json: schema: type: object description: Request parameters documented by ecommerce.amazon-product-database. properties: marketplace: type: string description: 'Target marketplace code. Options: us, uk, de, in, ca, fr, it, es, mx, jp' example: us includeKeywords: type: string description: Keywords to include in title/ASIN, comma-separated, up to 100 items, max 50 chars each example: phone case excludeKeywords: type: string description: Keywords to exclude from title/ASIN, comma-separated, up to 100 items, max 50 chars each example: phone case categories: type: string description: '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' minPrice: type: number description: Minimum price example: 1 maxPrice: type: number description: Maximum price example: 1 minSales: type: integer description: Minimum monthly sales example: 1 maxSales: type: integer description: Maximum monthly sales example: 1 minRevenue: type: number description: Minimum monthly revenue example: 1 maxRevenue: type: number description: Maximum monthly revenue example: 1 minReviews: type: integer description: Minimum number of reviews example: 1 maxReviews: type: integer description: Maximum number of reviews example: 1 minRating: type: number description: Minimum rating (1.0-5.0) example: 1 maxRating: type: number description: Maximum rating (1.0-5.0) example: 1 minWeight: type: number description: Minimum weight (lbs) example: 1 maxWeight: type: number description: Maximum weight (lbs) example: 1 minRank: type: integer description: Minimum BSR ranking example: 1 maxRank: type: integer description: Maximum BSR ranking example: 1 minLqs: type: integer description: Minimum LQS score (1-10) example: 1 maxLqs: type: integer description: Maximum LQS score (1-10) example: 1 minSellers: type: integer description: Minimum number of sellers example: 1 maxSellers: type: integer description: Maximum number of sellers example: 1 minNet: type: number description: Minimum net profit example: 1 maxNet: type: number description: Maximum net profit example: 1 sellerTypes: type: string description: 'Seller types, comma-separated. Options: amz (Amazon self-operated), fba, fbm' productTiers: type: string description: 'Product size tiers, comma-separated. Options: oversize, standard' excludeTopBrands: type: boolean description: Whether to exclude top brands example: false excludeUnavailableProducts: type: boolean description: Whether to exclude unavailable products example: false minUpdatedAt: type: string description: Data update start date (YYYY-MM-DD) example: '2026-01-01' maxUpdatedAt: type: string description: Data update end date (YYYY-MM-DD) example: '2026-01-01' needCount: type: integer description: Total number of results to return, API auto-paginates internally example: 1 sort: type: string description: 'Sort field. Options: name, -name, category, -category, revenue, -revenue, sales, -sales, price, -price, rank, -rank, reviews, -reviews, lqs, -lqs, sellers, -sellers. Prefix - indicates descending. Default: name' required: - marketplace example: sort: -sales marketplace: us includeKeywords: phone case needCount: 10 additionalProperties: true example: sort: -sales marketplace: us includeKeywords: phone case needCount: 10 responses: '200': description: Successful response. content: application/json: schema: type: object description: Returns the documented upstream API response directly without an additional wrapper. properties: costToken: type: integer description: Token consumption example: 1 productDatabaseList: type: array items: type: object properties: id: type: string description: Product unique identifier example: example-id title: type: string description: Product title brand: type: string description: Brand name category: type: string description: Primary category breadcrumbPath: type: string description: Full category path price: type: number description: Current selling price (USD) example: 1 approximate30DayUnitsSold: type: integer description: Estimated units sold in last 30 days example: 1 approximate30DayRevenue: type: number description: Estimated revenue in last 30 days (USD) example: 1 productRank: type: integer description: BSR ranking example: 1 reviews: type: integer description: Total number of reviews example: 1 rating: type: number description: Average rating (1.0-5.0) example: 1 listingQualityScore: type: integer description: Listing quality score (LQS, 1-10) example: 1 numberOfSellers: type: integer description: Number of active sellers example: 1 sellerType: type: string description: Seller type (amz/fba/fbm) imageUrl: type: string description: Product main image URL example: https://example.com/image.jpg dateFirstAvailable: type: string description: Date first listed example: '2026-01-01' weightValue: type: number description: Product weight example: 1 weightUnit: type: string description: Weight unit lengthValue: type: number description: Length example: 1 widthValue: type: number description: Width example: 1 heightValue: type: number description: Height example: 1 dimensionsUnit: type: string description: Dimensions unit parentAsin: type: string description: Parent ASIN example: B072MQ5BRX isParent: type: boolean description: Whether it is a parent listing example: false isVariant: type: boolean description: Whether it is a variant example: false isStandalone: type: boolean description: Whether it is a standalone product example: false isAvailable: type: boolean description: Whether it is available for purchase example: false buyBoxOwner: type: string description: Buy Box owner seller name buyBoxOwnerSellerId: type: string description: Buy Box owner seller ID example: example-id updatedAt: type: string description: Data update time example: '2026-01-01' feeBreakdown: type: object description: 'Fee details: fbaFee (FBA fee), referralFee (referral fee), variableClosingFee (variable closing fee), totalFees (total fees)' example: {} properties: {} additionalProperties: true subcategoryRanks: type: array items: {} description: Subcategory BSR ranking list, each item contains subcategory, rank, id example: [] type: type: string description: Resource type variants: type: array items: {} description: Variant list example: [] upcList: type: array items: {} description: UPC code list example: [] eanList: type: array items: {} description: EAN code list example: [] isbnList: type: array items: {} description: ISBN code list example: [] gtinList: type: array items: {} description: GTIN code list example: [] dateFirstAvailableIsEstimated: type: boolean description: Whether the listing date is estimated example: false additionalProperties: true description: Product data list example: [] errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. message: type: string description: Provider-specific message. type: type: string description: Provider-specific render or payload type. title: type: string description: Provider-specific response title. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. example: 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 additionalProperties: true example: 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 '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: amazon-product-database x-nexscope-mcp-tool-name: nexscope_amazon_product_database x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/amazon-product-database-search/run: post: tags: - Amazon Marketplace Intelligence summary: Amazon Product Database Search description: Advanced Amazon product search and filtering powered by Keepa data, supporting multi-dimensional criteria including category, price, monthly sales, keywords, BSR rank, review count, rating, package dimensions, weight, fulfillment type, and more. operationId: runAmazonProductDatabaseSearch externalDocs: description: Amazon Product Database Search documentation url: https://www.nexscope.ai/api-docs/amazon-product-database-search requestBody: required: true content: application/json: schema: type: object description: Request parameters documented by ecommerce.amazon-product-database-search. properties: domain: type: string description: 'Amazon domain ID: 1=United States, 2=United Kingdom, 3=Germany, 4=France, 5=Japan, 6=Canada, 8=Italy, 9=Spain, 10=India, 11=Mexico' example: '1' keyword: type: string description: Title keyword (case-insensitive; spaces mean AND tokenization; wrap keywords containing spaces in double quotes; prefix - for exclusion; & symbol is replaced with space; up to 50 keywords, max 1000 characters) example: phone case rootCategory: type: array items: {} description: Root category IDs (up to 50), only include products in these root categories example: [] rootCategoryNames: type: array items: {} description: Root category names (up to 50), used when rootCategory is empty; the system automatically looks up corresponding category IDs example: [] categoriesInclude: type: array items: {} description: Subcategory IDs to include only (up to 50), only include products directly listed in these subcategories example: [] categoriesIncludeNames: type: array items: {} description: 'Subcategory names to include (up to 50), used when categoriesInclude is empty; the system automatically looks up corresponding category IDs. Supports full category paths (separated by : or >) for more accurate results' example: [] categoriesExclude: type: array items: {} description: Subcategory IDs to exclude (up to 50) example: [] categoriesExcludeNames: type: array items: {} description: Subcategory names to exclude (up to 50), used when categoriesExclude is empty; the system automatically looks up corresponding category IDs. Supports full category paths for more accurate results example: [] currentSalesGte/currentSalesLte: type: integer description: Current sales rank range (lower value = better ranking) example: 1 avg90SalesGte/avg90SalesLte: type: integer description: 90-day average sales rank range example: 1 deltaPercent90SalesGte/deltaPercent90SalesLte: type: integer description: 90-day sales rank change percentage range example: 1 monthlySoldGte/monthlySoldLte: type: integer description: Units sold / monthly sales range example: 1 srAvgGte/srAvgLte: type: integer description: Historical sales rank range (positive integer, lower value = better ranking, used for the month specified by srAvgMonth) example: 1 srAvgMonth: type: string description: 'Historical sales rank - selected month (format: YYYYMM, e.g., 202511 for November 2025, within the last 36 months)' currentNewGte/currentNewLte: type: integer description: Current new price range (in minor currency unit) example: 1 currentBuyBoxShippingGte/currentBuyBoxShippingLte: type: integer description: Current Buy Box price with shipping range (in minor currency unit) example: 1 currentCountReviewsGte/currentCountReviewsLte: type: integer description: Current review count range example: 1 currentRatingGte/currentRatingLte: type: number description: Current rating range (0.0-5.0) example: 1 packageLengthGte/packageLengthLte: type: integer description: Package length range (mm) example: 1 packageWidthGte/packageWidthLte: type: integer description: Package width range (mm) example: 1 packageHeightGte/packageHeightLte: type: integer description: Package height range (mm) example: 1 packageWeightGte/packageWeightLte: type: integer description: Package weight range (grams) example: 1 brand: type: array items: {} description: Brand (OR match) example: [] color: type: array items: {} description: Color (OR match), filter products with specified colors example: [] size: type: array items: {} description: Size (OR match), filter products with specified sizes example: [] availableDateGte/availableDateLte: type: string description: 'Product listing time range (date format: yyyy-MM-dd)' example: '2026-01-01' buyBoxIsAmazon: type: boolean description: Whether the Buy Box seller is Amazon example: false buyBoxIsFBA: type: boolean description: Whether the Buy Box is FBA example: false isHazMat: type: boolean description: Whether it is hazardous material example: false variationCountGte/variationCountLte: type: integer description: Variation count range example: 1 currentCountNewGte/currentCountNewLte: type: integer description: Current new offer count range example: 1 outOfStockPercentage90Gte/outOfStockPercentage90Lte: type: integer description: 90-day out-of-stock percentage range example: 1 singleVariation: type: boolean description: Return only one variation; when set to true, multi-variation products will only return one variation example: false productType: type: array items: {} description: 'Product type filter (default [0,1,2]): 0=standard product, 1=downloadable product, 2=eBook, 5=variant parent ASIN' example: [] history: type: integer description: Whether to include historical data / historical sales in the response (1=include, 0=exclude, default 0) example: 1 rating: type: integer description: Whether to fetch rating info (1=fetch, 0=do not fetch, default 1) example: 1 page: type: integer description: Page number (starting from 1, default 1) example: 1 perPage: type: integer description: Maximum results per page (min 50, max 100, default 50) example: 50 sort: type: array items: {} description: 'Sort (up to 3): array of objects, each containing {"fieldName": "...", "sortDirection": "asc\' example: [] required: - domain example: page: 1 perPage: 50 domain: '1' keyword: phone case additionalProperties: true example: page: 1 perPage: 50 domain: '1' keyword: phone case responses: '200': description: Successful response. content: application/json: schema: type: object description: Returns the documented upstream API response directly without an additional wrapper. properties: total: type: integer description: Total rows example: 1 perPage: type: integer description: Items per page example: 1 currentPage: type: integer description: Current page number example: 1 totalCount: type: integer description: Total count example: 1 sourceType: type: string description: 'Source type: keepa' type: type: string description: Render style columns: type: array items: {} description: Rendered columns example: [] costToken: type: integer description: Token consumption example: 1 products: type: array items: type: object properties: asin: type: string description: ASIN example: B072MQ5BRX title: type: string description: Product title brand: type: string description: Brand manufacturer: type: string description: Manufacturer model: type: string description: Model price: type: number description: Current price (in local currency, e.g., USD/EUR) example: 1 primePrice: type: number description: Prime price example: 1 currency: type: string description: Currency salesRank: type: integer description: Sales rank example: 1 salesRank30: type: integer description: Average sales rank in last 30 days example: 1 salesRank90: type: integer description: Average sales rank in last 90 days example: 1 salesRank180: type: integer description: Average sales rank in last 180 days example: 1 monthlySalesUnits: type: integer description: Monthly sales units example: 1 monthlySalesRevenue: type: number description: Monthly sales revenue example: 1 rating: type: number description: Current rating (0.0-5.0) example: 1 ratings: type: integer description: Number of ratings example: 1 reviewCount: type: integer description: Number of reviews example: 1 availableDate: type: string description: Listing time (yyyy-MM-dd HH:mm:ss) example: '2026-01-01' lastUpdate: type: string description: Last update time (yyyy-MM-dd HH:mm:ss) example: '2026-01-01' imageUrl: type: string description: Image URL (request address) example: https://example.com/image.jpg productImageUrls: type: array items: {} description: Product image list example: [] asinUrl: type: string description: Amazon ASIN detail page URL example: B072MQ5BRX categoryTree: type: string description: Category tree categoryTreeId: type: string description: Category tree ID example: example-id rootCategory: type: integer description: Root category ID example: 1 subcategories: type: array items: {} description: Subcategory list, containing code (category ID), rank (ranking), label (category name) example: [] fulfillment: type: string description: Fulfillment method (AMZ, FBA, FBM) buyBoxSellerId: type: string description: Buy Box seller ID example: example-id sellerNum: type: integer description: Number of sellers example: 1 parentAsin: type: string description: Parent ASIN example: B072MQ5BRX variationNum: type: integer description: Number of variations example: 1 color: type: string description: Color dimension: type: string description: Dimensions dimensionsType: type: string description: Dimensions type material: type: string description: Product material, the primary material used in its construction weight: type: string description: Weight (grams) packageWeight: type: string description: Package weight (grams) packageLength: type: integer description: Package length (mm) example: 1 packageWidth: type: integer description: Package width (mm) example: 1 packageHeight: type: integer description: Package height (mm) example: 1 packageDimensions: type: string description: Package dimensions packageQuantity: type: integer description: Quantity of items in the package, 0 or -1 if unavailable example: 1 itemLength: type: integer description: Item length (mm), 0 or -1 if unavailable example: 1 itemWidth: type: integer description: Item width (mm), 0 or -1 if unavailable example: 1 itemHeight: type: integer description: Item height (mm), 0 or -1 if unavailable example: 1 isAdultProduct: type: boolean description: Whether it is an adult product example: false isHazmat: type: boolean description: Whether it is hazardous material example: false referralFeePercentage: type: number description: Referral fee percentage example: 1 fbaFees: type: number description: FBA fulfillment fee (in local currency) example: 1 profit: type: number description: Profit margin (percentage, e.g., 25.5 means 25.5%) example: 1 urlSlug: type: string description: URL slug example: https://example.com/image.jpg sourceType: type: string description: 'Source type: keepa' sourceTool: type: string description: Source tool additionalProperties: true description: Product list (see below) example: [] monthlySalesUnits1MonthAgo: type: object properties: monthlySalesUnits12MonthsAgo: type: integer description: Monthly sales units for each of the last 12 months example: 1 ? '' : type: object properties: monthlySalesUnits12MonthsAgo: type: integer additionalProperties: true additionalProperties: true errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. message: type: string description: Provider-specific message. title: type: string description: Provider-specific response title. sourceTool: type: string description: Provider-specific source tool name. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. example: total: 1 perPage: 1 currentPage: 1 totalCount: 1 columns: [] costToken: 1 products: - asin: B072MQ5BRX price: 1 primePrice: 1 salesRank: 1 salesRank30: 1 salesRank90: 1 salesRank180: 1 monthlySalesUnits: 1 monthlySalesRevenue: 1 rating: 1 ratings: 1 reviewCount: 1 availableDate: '2026-01-01' lastUpdate: '2026-01-01' imageUrl: https://example.com/image.jpg productImageUrls: [] asinUrl: B072MQ5BRX categoryTreeId: example-id rootCategory: 1 subcategories: [] buyBoxSellerId: example-id sellerNum: 1 parentAsin: B072MQ5BRX variationNum: 1 packageLength: 1 packageWidth: 1 packageHeight: 1 packageQuantity: 1 itemLength: 1 itemWidth: 1 itemHeight: 1 isAdultProduct: false isHazmat: false referralFeePercentage: 1 fbaFees: 1 profit: 1 urlSlug: https://example.com/image.jpg monthlySalesUnits1MonthAgo: ? '' : monthlySalesUnits12MonthsAgo: 1 additionalProperties: true example: total: 1 perPage: 1 currentPage: 1 totalCount: 1 columns: [] costToken: 1 products: - asin: B072MQ5BRX price: 1 primePrice: 1 salesRank: 1 salesRank30: 1 salesRank90: 1 salesRank180: 1 monthlySalesUnits: 1 monthlySalesRevenue: 1 rating: 1 ratings: 1 reviewCount: 1 availableDate: '2026-01-01' lastUpdate: '2026-01-01' imageUrl: https://example.com/image.jpg productImageUrls: [] asinUrl: B072MQ5BRX categoryTreeId: example-id rootCategory: 1 subcategories: [] buyBoxSellerId: example-id sellerNum: 1 parentAsin: B072MQ5BRX variationNum: 1 packageLength: 1 packageWidth: 1 packageHeight: 1 packageQuantity: 1 itemLength: 1 itemWidth: 1 itemHeight: 1 isAdultProduct: false isHazmat: false referralFeePercentage: 1 fbaFees: 1 profit: 1 urlSlug: https://example.com/image.jpg monthlySalesUnits1MonthAgo: ? '' : monthlySalesUnits12MonthsAgo: 1 '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: amazon-product-database-search x-nexscope-mcp-tool-name: nexscope_amazon_product_database_search x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/amazon-product-detail/run: post: tags: - Amazon Marketplace Intelligence summary: Amazon Product Detail description: Retrieve detailed Amazon product information by ASIN, including title, images, bullet points, specifications, A+ content, pricing, ratings & reviews, variants, and more. operationId: runAmazonProductDetail externalDocs: description: Amazon Product Detail documentation url: https://www.nexscope.ai/api-docs/amazon-product-detail requestBody: required: true content: application/json: schema: type: object description: Request parameters documented by ecommerce.amazon-product-detail. properties: asins: type: string description: 'ASIN list, supports batch query, up to 40 ASINs. Format: ^[A-Z0-9]+(,[A-Z0-9]+){0,39}$. Example: B072MQ5BRX,B08N5WRWNW' example: B072MQ5BRX amazonDomain: type: string description: 'Amazon country site, default amazon.com. Options: amazon.com, amazon.co.uk, amazon.de, amazon.fr, amazon.it, amazon.es, amazon.co.jp, amazon.ca, amazon.com.au, amazon.com.br, amazon.in, amazon.nl, amazon.se, amazon.pl, amazon.sg, amazon.sa, amazon.ae, amazon.com.tr, amazon.com.mx, amazon.eg, amazon.cn, amazon.com.be' language: type: string description: 'Language. Examples: en_US, de_DE, fr_FR, ja_JP, it_IT, es_ES, pt_BR, en_GB, zh_CN' deliveryZip: type: string description: 'Delivery zip code, used to get delivery-related pricing. Examples: 10001 (New York, US), 10115 (Berlin, Germany), EC1A 1BB (London, UK)' device: type: string description: 'Device type: desktop (default), mobile, tablet' returnBoughtTogether: type: boolean description: Whether to return frequently bought together items (boughtTogether), default false example: false returnRelatedProducts: type: boolean description: Whether to return related product list (relatedProducts), default false example: false returnAuthorsReviews: type: boolean description: Whether to return author review list (authorsReviews), default false example: false required: - asins example: returnRelatedProducts: false returnBoughtTogether: false asins: B072MQ5BRX returnAuthorsReviews: false additionalProperties: true example: returnRelatedProducts: false returnBoughtTogether: false asins: B072MQ5BRX returnAuthorsReviews: false responses: '200': description: Successful response. content: application/json: schema: type: object description: Returns the documented upstream API response directly without an additional wrapper. properties: total: type: integer description: Total rows example: 1 columns: type: array items: {} description: Rendered columns example: [] type: type: string description: Render style costToken: type: integer description: Token consumption example: 1 products: type: array items: type: object properties: asin: type: string description: ASIN code example: B072MQ5BRX title: type: string description: Product title brand: type: string description: Brand price: type: - string - integer description: Price example: 1 extractedPrice: type: number description: Extracted price example: 1 oldPrice: type: - string - integer description: Original price example: 1 extractedOldPrice: type: number description: Extracted original price example: 1 currency: type: string description: Currency discount: type: string description: Discount saveWithCoupon: type: string description: Amount saved with coupon rating: type: number description: Rating example: 1 ratings: type: integer description: Number of reviews example: 1 prime: type: boolean description: Whether it is a Prime item example: false stock: type: string description: Stock status delivery: type: string description: Delivery information link: type: string description: Link linkClean: type: string description: Clean link asinUrl: type: string description: Link example: B072MQ5BRX imageUrl: type: string description: Thumbnail example: https://example.com/image.jpg thumbnail: type: string description: Thumbnail productImageUrls: type: array items: {} description: Product image URL list example: [] aboutItem: type: array items: {} description: Bullet points example: [] productDescription: type: string description: Product description; when A+ content exists, this is a JSON string (see A+ structure below) description: type: string description: Product description dimension: type: string description: Product dimensions weight: type: string description: Weight tags: type: string description: Tag list badges: type: string description: Badge list climatePledgeFriendly: type: boolean description: Whether it is Climate Pledge Friendly example: false snapEbtEligible: type: boolean description: Whether SNAP EBT eligible example: false boughtLastMonth: type: string description: Units bought last month (string) boughtLastMonthCount: type: integer description: Units bought last month (number) example: 1 reviewsSummary: type: string description: Review summary reviewsImages: type: array items: {} description: Review image list example: [] sourceTool: type: string description: Source tool sourceType: type: string description: 'Source type: amazon' pageFileUrl: type: string description: Full page file URL example: https://example.com/image.jpg manufacturer: type: string description: Manufacturer productDimensions: type: string description: Product dimensions upc: type: string description: UPC code units: type: string description: Units review: type: integer description: Number of reviews example: 1 fiveStar: type: integer description: Five-star review count example: 1 fourStar: type: integer description: Four-star review count example: 1 threeStar: type: integer description: Three-star review count example: 1 twoStar: type: integer description: Two-star review count example: 1 oneStar: type: integer description: One-star review count example: 1 items: type: array items: {} description: Variant item list, each item contains name (name), asin (ASIN code), position (position), selected (whether selected) example: [] position: type: integer description: Module order example: 1 image: type: string description: A+ module main image URL (often contains aplus-media-library-service-media) example: https://example.com/image.jpg carouselImages: type: array items: {} description: Optional; carousel sub-items, each containing position / title / image example: [] priceUnit: type: string description: Unit price text: type: string description: Review content author: type: string description: Author authorLink: type: string description: Author link helpfulVotes: type: string description: Helpful vote count productSize: type: string description: Product size productFlavorName: type: string description: Product flavor name additionalProperties: true description: Product list (see below) example: [] asin: type: string description: ASIN code example: B072MQ5BRX title: type: string description: Title extractedPrice: type: number description: Extracted price example: 1 extractedPriceUnit: type: number description: Extracted unit price example: 1 delivery: type: array items: {} description: Delivery information example: [] position: type: integer description: Position example: 1 extractedOldPrice: type: number description: Extracted original price example: 1 rating: type: number description: Rating example: 1 reviews: type: integer description: Number of reviews example: 1 prime: type: boolean description: Whether it is a Prime item example: false sponsored: type: boolean description: Whether it is a sponsored item example: false climatePledgeFriendly: type: boolean description: Whether Climate Pledge Friendly example: false badges: type: array items: {} description: Badge list example: [] authorImage: type: string description: Author avatar example: https://example.com/image.jpg date: type: string description: Date example: '2026-01-01' verifiedPurchase: type: boolean description: Whether verified purchase example: false errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. message: type: string description: Provider-specific message. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. example: total: 1 columns: [] costToken: 1 products: - asin: B072MQ5BRX price: 1 extractedPrice: 1 oldPrice: 1 extractedOldPrice: 1 rating: 1 ratings: 1 prime: false asinUrl: B072MQ5BRX imageUrl: https://example.com/image.jpg productImageUrls: [] aboutItem: [] climatePledgeFriendly: false snapEbtEligible: false boughtLastMonthCount: 1 reviewsImages: [] pageFileUrl: https://example.com/image.jpg review: 1 fiveStar: 1 fourStar: 1 threeStar: 1 twoStar: 1 oneStar: 1 items: [] position: 1 image: https://example.com/image.jpg carouselImages: [] asin: B072MQ5BRX extractedPrice: 1 extractedPriceUnit: 1 delivery: [] position: 1 extractedOldPrice: 1 rating: 1 reviews: 1 prime: false sponsored: false climatePledgeFriendly: false badges: [] authorImage: https://example.com/image.jpg date: '2026-01-01' verifiedPurchase: false additionalProperties: true example: total: 1 columns: [] costToken: 1 products: - asin: B072MQ5BRX price: 1 extractedPrice: 1 oldPrice: 1 extractedOldPrice: 1 rating: 1 ratings: 1 prime: false asinUrl: B072MQ5BRX imageUrl: https://example.com/image.jpg productImageUrls: [] aboutItem: [] climatePledgeFriendly: false snapEbtEligible: false boughtLastMonthCount: 1 reviewsImages: [] pageFileUrl: https://example.com/image.jpg review: 1 fiveStar: 1 fourStar: 1 threeStar: 1 twoStar: 1 oneStar: 1 items: [] position: 1 image: https://example.com/image.jpg carouselImages: [] asin: B072MQ5BRX extractedPrice: 1 extractedPriceUnit: 1 delivery: [] position: 1 extractedOldPrice: 1 rating: 1 reviews: 1 prime: false sponsored: false climatePledgeFriendly: false badges: [] authorImage: https://example.com/image.jpg date: '2026-01-01' verifiedPurchase: false '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: amazon-product-detail x-nexscope-mcp-tool-name: nexscope_amazon_product_detail x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/amazon-product-discovery/run: post: tags: - Amazon Marketplace Intelligence summary: Amazon Product Discovery description: Amazon product discovery and potential bestseller mining via Jiimore data. Triggered when users mention product mining, potential bestsellers, high-conversion product selection, click growth analysis, market growth opportunities, keyword-based product selection, FBA profit screening, niche market product discovery, seller origin filtering, Jiimore data, FBA profitability screening, keyword-based product selection. Even if users do not explicitly mention "Jiimore", this skill should be triggered whenever the task involves keyword-driven Amazon product selection based on conversion rates, click volume, and profitability metrics. operationId: runAmazonProductDiscovery externalDocs: description: Amazon Product Discovery documentation url: https://www.nexscope.ai/api-docs/amazon-product-discovery requestBody: required: true content: application/json: schema: type: object description: Request parameters documented by ecommerce.amazon-product-discovery. properties: keyword: type: string description: Keyword (required; translate the keyword to the language of the selected country) example: phone case countryCode: type: string description: 'Country, use country abbreviation. Default US. Options: US, JP, DE' priceMin: type: number description: Minimum product price example: 1 priceMax: type: number description: Maximum product price example: 1 totalReviewsMin: type: integer description: Minimum number of reviews example: 1 totalReviewsMax: type: integer description: Maximum number of reviews example: 1 customerRatingMin: type: number description: Minimum rating example: 1 customerRatingMax: type: number description: Maximum rating example: 1 clickConversionRateMin: type: number description: Minimum click-to-purchase conversion rate, value range 0-1, 0.1 means 10% example: 1 clickConversionRateMax: type: number description: Maximum click-to-purchase conversion rate, value range 0-1, 0.1 means 10% example: 1 clickConversionRateCompositeMin: type: number description: Minimum composite conversion rate, value range 0-1, 0.1 means 10% example: 1 clickConversionRateCompositeMax: type: number description: Maximum composite conversion rate, value range 0-1, 0.1 means 10% example: 1 clickCountT7Min: type: integer description: Minimum weekly click count example: 1 clickCountT7Max: type: integer description: Maximum weekly click count example: 1 clickCountT30Min: type: integer description: Minimum monthly click count example: 1 clickCountT30Max: type: integer description: Maximum monthly click count example: 1 clickCountGrowthT7Min: type: number description: Minimum weekly click growth rate, value range 0-1, 0.1 means 10% example: 1 clickCountGrowthT7Max: type: number description: Maximum weekly click growth rate, value range 0-1, 0.1 means 10% example: 1 clickCountGrowthT30Min: type: number description: Minimum monthly click growth rate, value range 0-1, 0.1 means 10% example: 1 clickCountGrowthT30Max: type: number description: Maximum monthly click growth rate, value range 0-1, 0.1 means 10% example: 1 salesVolumeT360Min: type: integer description: Minimum annual sales volume example: 1 salesVolumeT360Max: type: integer description: Maximum annual sales volume example: 1 grossProfitMarginMin: type: number description: Minimum gross profit margin example: 1 grossProfitMarginMax: type: number description: Maximum gross profit margin example: 1 fbaFeeMin: type: number description: Minimum FBA fee example: 1 fbaFeeMax: type: number description: Maximum FBA fee example: 1 launchDateMin: type: string description: 'Earliest listing time, format: yyyyMMdd000000' example: '2026-01-01' launchDateMax: type: string description: 'Latest listing time, format: yyyyMMdd000000' example: '2026-01-01' nicheCountMin: type: integer description: Minimum niche market count example: 1 nicheCountMax: type: integer description: Maximum niche market count example: 1 sellerCountry: type: string description: 'Seller country/region code, comma-separated for multiple selections, e.g.: CN,US' sortField: type: string description: 'Sort field. Default purchasedClicksT360. Options: totalReviews (total reviews), price (price), launchDate (listing time), clickCountT7 (7-day click count), clickCountT30 (30-day click count), clickCountT90 (90-day click count), clickConversionRate (click-to-purchase conversion rate), clickConversionRateComposite (composite click-to-purchase conversion rate), customerRating (rating), purchasedClicksT360 (360-day purchase clicks), clickCountGrowthT7 (weekly click growth rate), clickCountGrowthT30 (monthly click growth rate), currentPrice (current price), fbaFee (FBA fee), shippingFee (FBA shipping), gpm (gross profit margin)' sortType: type: string description: 'Sort direction. Default desc. Options: desc (descending), asc (ascending)' page: type: integer description: Page number. Default 1 example: 1 pageSize: type: integer description: Items per page (10-100). Default 50 example: 10 required: - keyword example: page: 1 countryCode: US keyword: phone case pageSize: 10 additionalProperties: true example: page: 1 countryCode: US keyword: phone case pageSize: 10 responses: '200': description: Successful response. content: application/json: schema: type: object description: Returns the documented upstream API response directly without an additional wrapper. properties: total: type: integer description: Total count example: 1 sourceTool: type: string description: 'Tool type: jiimore' sourceType: type: string description: 'Source type: amazon' type: type: string description: Render style title: type: string description: Title costToken: type: integer description: Token consumption example: 1 columns: type: array items: {} description: Rendered columns example: [] products: type: array items: type: object properties: asin: type: string description: Amazon product ASIN example: B072MQ5BRX parentAsin: type: string description: Amazon product parent ASIN example: B072MQ5BRX title: type: string description: Product title brand: type: string description: Brand price: type: number description: Price example: 1 imageUrl: type: string description: Product main image example: https://example.com/image.jpg productImageUrls: type: array items: {} description: Product image URL list example: [] asinUrl: type: string description: ASIN link example: B072MQ5BRX ratings: type: integer description: Number of reviews example: 1 availableDate: type: string description: Listing time (timestamp) example: '2026-01-01' availableDateString: type: string description: Listing date (string) example: '2026-01-01' categoryNames: type: array items: {} description: Category information example: [] marketplaceId: type: string description: Site ID example: US clickCountT7: type: integer description: Weekly click count example: 1 clickCountT30: type: integer description: Monthly click count example: 1 clickCountT90: type: integer description: Quarterly click count example: 1 clickConversionRate: type: number description: Click-to-purchase conversion rate example: 1 clickConversionRateComposite: type: number description: Composite conversion rate example: 1 grossProfitMargin: type: number description: Gross profit margin example: 1 fbaFee: type: number description: Amazon fee example: 1 shippingFee: type: number description: FBA shipping fee example: 1 sourceTool: type: string description: 'Tool type: jiimore' sourceType: type: string description: 'Source type: amazon' additionalProperties: true description: Product list (see below) example: [] errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. message: type: string description: Provider-specific message. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. example: total: 1 costToken: 1 columns: [] products: - asin: B072MQ5BRX parentAsin: B072MQ5BRX price: 1 imageUrl: https://example.com/image.jpg productImageUrls: [] asinUrl: B072MQ5BRX ratings: 1 availableDate: '2026-01-01' availableDateString: '2026-01-01' categoryNames: [] marketplaceId: US clickCountT7: 1 clickCountT30: 1 clickCountT90: 1 clickConversionRate: 1 clickConversionRateComposite: 1 grossProfitMargin: 1 fbaFee: 1 shippingFee: 1 additionalProperties: true example: total: 1 costToken: 1 columns: [] products: - asin: B072MQ5BRX parentAsin: B072MQ5BRX price: 1 imageUrl: https://example.com/image.jpg productImageUrls: [] asinUrl: B072MQ5BRX ratings: 1 availableDate: '2026-01-01' availableDateString: '2026-01-01' categoryNames: [] marketplaceId: US clickCountT7: 1 clickCountT30: 1 clickCountT90: 1 clickConversionRate: 1 clickConversionRateComposite: 1 grossProfitMargin: 1 fbaFee: 1 shippingFee: 1 '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: amazon-product-discovery x-nexscope-mcp-tool-name: nexscope_amazon_product_discovery x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/amazon-product-history/run: post: tags: - Amazon Marketplace Intelligence summary: Amazon Product History description: Retrieve Amazon product details by ASIN, including price, title, main image, listing date, material, weight, variant monthly sales, and up to 12 months of monthly sales history. Triggered when users query Amazon product details, ASIN lookup, product pricing, sales rank history, monthly sales trends, product dimensions, FBA fees, product specifications, batch ASIN query, Keepa product details, ASIN detail lookup, monthly sales data, pricing info, product specifications, FBA fees, batch ASIN query. Even if users do not explicitly mention "Keepa", this skill should be triggered whenever the task involves obtaining structured product data for one or more Amazon ASINs. operationId: runAmazonProductHistory externalDocs: description: Amazon Product History documentation url: https://www.nexscope.ai/api-docs/amazon-product-history requestBody: required: true content: application/json: schema: type: object description: Request parameters documented by ecommerce.amazon-product-history. properties: asin: type: string description: 'Amazon Standard Identification Number (ASIN), multiple ASINs separated by English commas, up to 5, max length 300 characters. Example: B0088PUEPK or B0088PUEPK,B00U26V4VQ,B07M68S376' example: B072MQ5BRX domain: type: string description: 'Amazon domain ID. Options: 1 (United States), 2 (United Kingdom), 3 (Germany), 4 (France), 5 (Japan), 6 (Canada), 8 (Italy), 9 (Spain), 10 (India), 11 (Mexico), 12 (Brazil)' example: '1' history: type: integer description: 'Whether to include historical data and historical sales in the response. 1 = include price history, sales rank, historical sales and other time-series data (sales for previous months), 0 = return only basic product information. Default: 0' example: 1 required: - asin - domain example: domain: '1' history: 1 asin: B072MQ5BRX additionalProperties: true example: domain: '1' history: 1 asin: B072MQ5BRX responses: '200': description: Successful response. content: application/json: schema: type: object description: Returns the documented upstream API response directly without an additional wrapper. properties: total: type: integer description: Total rows example: 1 perPage: type: integer description: Items per page example: 1 sourceType: type: string description: 'Source type: keepa' columns: type: array items: {} description: Rendered columns example: [] costToken: type: integer description: Token consumption example: 1 totalCount: type: integer description: Total count example: 1 currentPage: type: integer description: Current page number example: 1 type: type: string description: Render style products: type: array items: type: object properties: asin: type: string description: ASIN example: B072MQ5BRX title: type: string description: Product title brand: type: string description: Brand manufacturer: type: string description: Manufacturer model: type: string description: Model color: type: string description: Color material: type: string description: Product material, the primary material used in its construction price: type: number description: Current price (in local currency, e.g., USD/EUR) example: 1 primePrice: type: number description: Prime price example: 1 currency: type: string description: Currency rating: type: number description: Current rating (0.0-5.0, e.g., 4.5 stars) example: 1 ratings: type: integer description: Number of ratings example: 1 reviewCount: type: integer description: Number of reviews example: 1 salesRank: type: integer description: Sales rank example: 1 salesRank30: type: integer description: Average sales rank in last 30 days example: 1 salesRank90: type: integer description: Average sales rank in last 90 days example: 1 salesRank180: type: integer description: Average sales rank in last 180 days example: 1 monthlySalesUnits: type: integer description: Monthly sales units example: 1 monthlySalesRevenue: type: number description: Monthly sales revenue example: 1 monthlySalesUnits1MonthAgo: type: integer description: Monthly sales 1 month ago example: 1 monthlySalesUnits2MonthsAgo: type: integer description: Monthly sales 2 months ago example: 1 monthlySalesUnits3MonthsAgo: type: integer description: Monthly sales 3 months ago example: 1 monthlySalesUnits4MonthsAgo: type: integer description: Monthly sales 4 months ago example: 1 monthlySalesUnits5MonthsAgo: type: integer description: Monthly sales 5 months ago example: 1 monthlySalesUnits6MonthsAgo: type: integer description: Monthly sales 6 months ago example: 1 monthlySalesUnits7MonthsAgo: type: integer description: Monthly sales 7 months ago example: 1 monthlySalesUnits8MonthsAgo: type: integer description: Monthly sales 8 months ago example: 1 monthlySalesUnits9MonthsAgo: type: integer description: Monthly sales 9 months ago example: 1 monthlySalesUnits10MonthsAgo: type: integer description: Monthly sales 10 months ago example: 1 monthlySalesUnits11MonthsAgo: type: integer description: Monthly sales 11 months ago example: 1 monthlySalesUnits12MonthsAgo: type: integer description: Monthly sales 12 months ago example: 1 availableDate: type: string description: Listing time (yyyy-MM-dd HH:mm:ss) example: '2026-01-01' lastUpdate: type: string description: Last update time (yyyy-MM-dd HH:mm:ss) example: '2026-01-01' imageUrl: type: string description: Image URL (request address) example: https://example.com/image.jpg productImageUrls: type: array items: {} description: Product image list example: [] asinUrl: type: string description: Amazon ASIN detail page URL example: B072MQ5BRX urlSlug: type: string description: URL slug example: https://example.com/image.jpg itemLength: type: integer description: Item length in millimeters, 0 or -1 if unavailable example: 1 itemWidth: type: integer description: Item width in millimeters, 0 or -1 if unavailable example: 1 itemHeight: type: integer description: Item height in millimeters, 0 or -1 if unavailable example: 1 dimension: type: string description: Dimensions dimensionsType: type: string description: Dimensions type weight: type: string description: Weight (grams) packageLength: type: integer description: Package length (mm) example: 1 packageWidth: type: integer description: Package width (mm) example: 1 packageHeight: type: integer description: Package height (mm) example: 1 packageWeight: type: string description: Package weight (grams) packageDimensions: type: string description: Package dimensions packageQuantity: type: integer description: Quantity of items in the package, 0 or -1 if unavailable example: 1 fulfillment: type: string description: Fulfillment method (AMZ, FBA, FBM) fbaFees: type: number description: FBA fulfillment fee (in local currency) example: 1 referralFeePercentage: type: number description: Referral fee percentage example: 1 profit: type: number description: Profit margin (percentage, e.g., 25.5 means 25.5%) example: 1 buyBoxSellerId: type: string description: Buy Box seller ID example: example-id sellerNum: type: integer description: Number of sellers example: 1 variationNum: type: integer description: Number of variations example: 1 parentAsin: type: string description: Parent ASIN example: B072MQ5BRX rootCategory: type: integer description: Root category ID example: 1 categoryTree: type: string description: Category tree categoryTreeId: type: string description: Category tree ID example: example-id subcategories: type: array items: {} description: Subcategory list, each element contains code (category ID), rank (ranking), label (category name) example: [] isAdultProduct: type: boolean description: Whether it is an adult product example: false isHazmat: type: boolean description: Whether it is hazardous material example: false sourceType: type: string description: 'Source type: keepa' sourceTool: type: string description: Source tool additionalProperties: true description: Product list (see below) example: [] errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. message: type: string description: Provider-specific message. title: type: string description: Provider-specific response title. sourceTool: type: string description: Provider-specific source tool name. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. example: total: 1 perPage: 1 columns: [] costToken: 1 totalCount: 1 currentPage: 1 products: - asin: B072MQ5BRX price: 1 primePrice: 1 rating: 1 ratings: 1 reviewCount: 1 salesRank: 1 salesRank30: 1 salesRank90: 1 salesRank180: 1 monthlySalesUnits: 1 monthlySalesRevenue: 1 monthlySalesUnits1MonthAgo: 1 monthlySalesUnits2MonthsAgo: 1 monthlySalesUnits3MonthsAgo: 1 monthlySalesUnits4MonthsAgo: 1 monthlySalesUnits5MonthsAgo: 1 monthlySalesUnits6MonthsAgo: 1 monthlySalesUnits7MonthsAgo: 1 monthlySalesUnits8MonthsAgo: 1 monthlySalesUnits9MonthsAgo: 1 monthlySalesUnits10MonthsAgo: 1 monthlySalesUnits11MonthsAgo: 1 monthlySalesUnits12MonthsAgo: 1 availableDate: '2026-01-01' lastUpdate: '2026-01-01' imageUrl: https://example.com/image.jpg productImageUrls: [] asinUrl: B072MQ5BRX urlSlug: https://example.com/image.jpg itemLength: 1 itemWidth: 1 itemHeight: 1 packageLength: 1 packageWidth: 1 packageHeight: 1 packageQuantity: 1 fbaFees: 1 referralFeePercentage: 1 profit: 1 buyBoxSellerId: example-id sellerNum: 1 variationNum: 1 parentAsin: B072MQ5BRX rootCategory: 1 categoryTreeId: example-id subcategories: [] isAdultProduct: false isHazmat: false additionalProperties: true example: total: 1 perPage: 1 columns: [] costToken: 1 totalCount: 1 currentPage: 1 products: - asin: B072MQ5BRX price: 1 primePrice: 1 rating: 1 ratings: 1 reviewCount: 1 salesRank: 1 salesRank30: 1 salesRank90: 1 salesRank180: 1 monthlySalesUnits: 1 monthlySalesRevenue: 1 monthlySalesUnits1MonthAgo: 1 monthlySalesUnits2MonthsAgo: 1 monthlySalesUnits3MonthsAgo: 1 monthlySalesUnits4MonthsAgo: 1 monthlySalesUnits5MonthsAgo: 1 monthlySalesUnits6MonthsAgo: 1 monthlySalesUnits7MonthsAgo: 1 monthlySalesUnits8MonthsAgo: 1 monthlySalesUnits9MonthsAgo: 1 monthlySalesUnits10MonthsAgo: 1 monthlySalesUnits11MonthsAgo: 1 monthlySalesUnits12MonthsAgo: 1 availableDate: '2026-01-01' lastUpdate: '2026-01-01' imageUrl: https://example.com/image.jpg productImageUrls: [] asinUrl: B072MQ5BRX urlSlug: https://example.com/image.jpg itemLength: 1 itemWidth: 1 itemHeight: 1 packageLength: 1 packageWidth: 1 packageHeight: 1 packageQuantity: 1 fbaFees: 1 referralFeePercentage: 1 profit: 1 buyBoxSellerId: example-id sellerNum: 1 variationNum: 1 parentAsin: B072MQ5BRX rootCategory: 1 categoryTreeId: example-id subcategories: [] isAdultProduct: false isHazmat: false '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: amazon-product-history x-nexscope-mcp-tool-name: nexscope_amazon_product_history x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/amazon-product-price-series/run: post: tags: - Amazon Marketplace Intelligence summary: Amazon Product Price Series description: Query Amazon product historical time-series data, including price trends, BSR (Best Sellers Rank) trends, rating changes, seller counts, and monthly sales, supporting any ASIN across multiple Amazon marketplaces. Triggered when users mention price history, price tracking, BSR history, BSR trends, historical pricing, price fluctuations, Keepa data, rank history, price drop alerts, lightning deal historical prices, Buy Box price trends, coupon prices, FBA/FBM price comparison, seller count changes, rating trends, sales history. Even if users do not explicitly mention "Keepa" or "time-series data", this skill should be triggered whenever the task involves analyzing Amazon product-level historical data (such as price, rank, or sales trends over time). operationId: runAmazonProductPriceSeries externalDocs: description: Amazon Product Price Series documentation url: https://www.nexscope.ai/api-docs/amazon-product-price-series requestBody: required: true content: application/json: schema: type: object description: Request parameters documented by ecommerce.amazon-product-price-series. properties: asin: type: string description: Amazon Standard Identification Number (ASIN), single ASIN only, max length 1000 example: B072MQ5BRX domain: type: string description: 'Amazon domain ID. Options: 1 (United States), 2 (United Kingdom), 3 (Germany), 4 (France), 5 (Japan), 6 (Canada), 8 (Italy), 9 (Spain), 10 (India), 11 (Mexico), 12 (Brazil)' example: '1' days: type: integer description: Limit historical data to this many days, default 90, max 365 example: 30 showPrice: type: integer description: Set to 1 to return the lowest new price curve in the market example: 1 showPriceList: type: integer description: Set to 1 to return the list/strikethrough price curve example: 1 showPriceDeal: type: integer description: Set to 1 to return the deal/flash sale price curve example: 1 showPricePrime: type: integer description: Set to 1 to return the Prime-exclusive new price curve example: 1 showPriceFba: type: integer description: Set to 1 to return the third-party FBA new price curve example: 1 showPriceFbm: type: integer description: Set to 1 to return the third-party FBM new price curve example: 1 showPriceCoupon: type: integer description: Set to 1 to return the coupon-applied Buy Box price curve example: 1 showBsrMain: type: integer description: Set to 1 to return the main category BSR curve example: 1 showSellerCount: type: integer description: Set to 1 to return the seller count curve example: 1 required: - asin - domain example: showPricePrime: 1 showPriceList: 1 domain: '1' showPriceDeal: 1 days: 30 asin: B072MQ5BRX showPrice: 1 additionalProperties: true example: showPricePrime: 1 showPriceList: 1 domain: '1' showPriceDeal: 1 days: 30 asin: B072MQ5BRX showPrice: 1 responses: '200': description: Successful response. content: application/json: schema: type: object description: Returns the documented upstream API response directly without an additional wrapper. properties: asin: type: string description: ASIN example: B072MQ5BRX buyboxPrice: type: array items: {} description: Buy Box price (time=timestamp, value=Buy Box price) example: [] price: type: array items: {} description: Price (time=timestamp, value=price) example: [] priceList: type: array items: {} description: List/strikethrough price (time=timestamp, value=list price) example: [] priceDeal: type: array items: {} description: Deal price (time=timestamp, value=deal price) example: [] pricePrime: type: array items: {} description: Prime price (time=timestamp, value=Prime price) example: [] priceFba: type: array items: {} description: FBA price (time=timestamp, value=FBA price) example: [] priceFbm: type: array items: {} description: FBM price (time=timestamp, value=FBM price) example: [] priceCoupon: type: array items: {} description: Coupon price (time=timestamp, value=coupon price) example: [] bsrMain: type: array items: {} description: Main category BSR, each element contains categoryName (category name) and points (time=timestamp, value=ranking) example: [] bsrSub: type: array items: {} description: Subcategory BSR, each element contains categoryName (category name) and points (time=timestamp, value=ranking) example: [] sellerCount: type: array items: {} description: Seller count (time=timestamp, value=seller count) example: [] rating: type: array items: {} description: Rating (time=timestamp, value=rating) example: [] ratingCount: type: array items: {} description: Rating count (time=timestamp, value=rating count) example: [] monthlySold: type: array items: {} description: Child ASIN sales (time=timestamp, value=sales units) example: [] costToken: type: integer description: Token consumption example: 1 errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. message: type: string description: Provider-specific message. type: type: string description: Provider-specific render or payload type. title: type: string description: Provider-specific response title. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. example: asin: B072MQ5BRX buyboxPrice: [] price: [] priceList: [] priceDeal: [] pricePrime: [] priceFba: [] priceFbm: [] priceCoupon: [] bsrMain: [] bsrSub: [] sellerCount: [] rating: [] ratingCount: [] monthlySold: [] costToken: 1 additionalProperties: true example: asin: B072MQ5BRX buyboxPrice: [] price: [] priceList: [] priceDeal: [] pricePrime: [] priceFba: [] priceFbm: [] priceCoupon: [] bsrMain: [] bsrSub: [] sellerCount: [] rating: [] ratingCount: [] monthlySold: [] costToken: 1 '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: amazon-product-price-series x-nexscope-mcp-tool-name: nexscope_amazon_product_price_series x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/amazon-product-research/run: post: tags: - Amazon Marketplace Intelligence summary: Amazon Product Research Directory description: Use this directory to find the concrete API for a research goal. It returns links and typical inputs; invoke the linked API for the actual research data. operationId: runAmazonProductResearch externalDocs: description: Amazon Product Research Directory documentation url: https://www.nexscope.ai/api-docs/amazon-product-research requestBody: required: true content: application/json: schema: type: object description: Optional category filter. Use all to list every original Amazon product-research operation. properties: goal: type: string description: 'Optional filter: all, search, detail, reviews, image-search, opportunity, keyword, price-history, or sales-estimates.' example: all example: goal: all additionalProperties: true example: goal: all responses: '200': description: Successful response. content: application/json: schema: type: object description: Returns a complete directory of concrete Amazon research APIs. This endpoint does not execute a research query itself. properties: directoryType: type: string description: Identifies this response as an API directory, not a research result. example: amazon-product-research-directory goal: type: string description: Applied directory filter. example: all count: type: integer description: Number of concrete API entries returned. example: 33 recommendedApis: type: array items: type: object properties: operation: type: string description: Original Skill operation name. example: amazon_search slug: type: string description: Concrete Skill API slug to invoke. example: amazon-search endpoint: type: string description: Concrete Skill API run endpoint. example: /api/skill-api/v1/skills/amazon-search/run reason: type: string description: What the concrete API executes. example: Search Amazon storefront results by keyword. typicalFields: type: array items: type: string description: Typical inputs for navigation; the linked API schema is authoritative. example: - keyword - marketplace requestExample: type: object description: Example request for the concrete API. example: marketplace: US keyword: wireless speaker properties: marketplace: type: string keyword: type: string additionalProperties: true required: - operation - slug - endpoint - reason - typicalFields - requestExample additionalProperties: true description: Concrete APIs that execute the selected research operation. example: [] usage: type: string description: Next step for callers. example: Invoke one recommended API directly for the actual research result. errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. message: type: string description: Provider-specific message. type: type: string description: Provider-specific render or payload type. title: type: string description: Provider-specific response title. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. costToken: type: integer description: Token cost reported by the upstream provider. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. required: - directoryType - goal - count - recommendedApis - usage example: directoryType: amazon-product-research-directory goal: all count: 33 recommendedApis: - slug: amazon-search endpoint: /api/skill-api/v1/skills/amazon-search/run reason: Search Amazon storefront results by keyword. requestExample: marketplace: US keyword: wireless speaker typicalFields: - keyword - marketplace operation: amazon_search - slug: amazon-alexa-search endpoint: /api/skill-api/v1/skills/amazon-alexa-search/run reason: Search Amazon Alexa ranking and product results. requestExample: marketplace: US keyword: wireless speaker typicalFields: - keyword - marketplace operation: amazon_alexa_search usage: Invoke one recommended API directly for the actual research result. additionalProperties: true example: directoryType: amazon-product-research-directory goal: all count: 33 recommendedApis: - slug: amazon-search endpoint: /api/skill-api/v1/skills/amazon-search/run reason: Search Amazon storefront results by keyword. requestExample: marketplace: US keyword: wireless speaker typicalFields: - keyword - marketplace operation: amazon_search - slug: amazon-alexa-search endpoint: /api/skill-api/v1/skills/amazon-alexa-search/run reason: Search Amazon Alexa ranking and product results. requestExample: marketplace: US keyword: wireless speaker typicalFields: - keyword - marketplace operation: amazon_alexa_search usage: Invoke one recommended API directly for the actual research result. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: amazon-product-research x-nexscope-mcp-tool-name: nexscope_amazon_product_research x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/amazon-related-asins/run: post: tags: - Amazon Marketplace Intelligence summary: Amazon Related Asins description: Find Amazon same-niche competitors by ASIN, with multi-dimensional filtering by click conversion rate, composite conversion rate, click volume, sales volume, reviews, ratings, price, and gross margin to identify potential competitors. Triggered when users mention same-niche competitors, ASIN competitor mining, niche competitor analysis, similar product benchmarking, ASIN benchmarking, niche market competitor list, high-conversion competitor screening, Jiimore product mining, niche competitor by ASIN, ASIN competitor analysis, same niche products, similar products discovery, conversion rate comparison, potential competitor screening, Jiimore ASIN mining. Even if users do not explicitly mention "niche" or "same niche", this skill should be triggered whenever the task involves discovering competitor lists or screening potential competitors based on a specific ASIN within the same market segment. operationId: runAmazonRelatedAsins externalDocs: description: Amazon Related Asins documentation url: https://www.nexscope.ai/api-docs/amazon-related-asins requestBody: required: true content: application/json: schema: type: object description: Request parameters documented by ecommerce.amazon-related-asins. properties: asin: type: string description: Reference ASIN, used to query competitor listings that belong to the same niche as this ASIN, max length 1000 characters example: B072MQ5BRX countryCode: type: string description: 'Country code, options: US (United States), JP (Japan), DE (Germany)' page: type: integer description: Page number (starting from 1) example: 1 pageSize: type: integer description: Items returned per page (10-100) example: 10 sortField: type: string description: Sort field (see sort options below) sortType: type: string description: 'Sort direction: desc (descending) or asc (ascending)' priceMin: type: number description: Minimum product price example: 1 priceMax: type: number description: Maximum product price example: 1 fbaFeeMin: type: number description: Minimum FBA fee example: 1 fbaFeeMax: type: number description: Maximum FBA fee example: 1 grossProfitMarginMin: type: number description: Minimum gross profit margin example: 1 grossProfitMarginMax: type: number description: Maximum gross profit margin example: 1 totalReviewsMin: type: integer description: Minimum review count example: 1 totalReviewsMax: type: integer description: Maximum review count example: 1 customerRatingMin: type: number description: Minimum rating, range 0.0-5.0 example: 1 customerRatingMax: type: number description: Maximum rating, range 0.0-5.0 example: 1 clickCountT7Min: type: integer description: Minimum weekly click count example: 1 clickCountT7Max: type: integer description: Maximum weekly click count example: 1 clickCountGrowthT7Min: type: number description: Minimum weekly click growth rate, range 0-1, e.g., 0.1 means 10% example: 1 clickCountGrowthT7Max: type: number description: Maximum weekly click growth rate, range 0-1, e.g., 0.1 means 10% example: 1 clickConversionRateMin: type: number description: Minimum click conversion rate, range 0-1, e.g., 0.1 means 10% example: 1 clickConversionRateMax: type: number description: Maximum click conversion rate, range 0-1, e.g., 0.1 means 10% example: 1 clickCountT30Min: type: integer description: Minimum monthly click count example: 1 clickCountT30Max: type: integer description: Maximum monthly click count example: 1 clickCountGrowthT30Min: type: number description: Minimum monthly click growth rate, range 0-1, e.g., 0.1 means 10% example: 1 clickCountGrowthT30Max: type: number description: Maximum monthly click growth rate, range 0-1, e.g., 0.1 means 10% example: 1 clickConversionRateCompositeMin: type: number description: Minimum composite click conversion rate, range 0-1, e.g., 0.1 means 10% example: 1 clickConversionRateCompositeMax: type: number description: Maximum composite click conversion rate, range 0-1, e.g., 0.1 means 10% example: 1 salesVolumeT360Min: type: integer description: Minimum annual sales volume example: 1 salesVolumeT360Max: type: integer description: Maximum annual sales volume example: 1 launchDateMin: type: string description: Earliest listing time, format yyyyMMdd000000 example: '2026-01-01' launchDateMax: type: string description: Latest listing time, format yyyyMMdd000000 example: '2026-01-01' nicheCountMin: type: integer description: Minimum number of niche markets example: 1 nicheCountMax: type: integer description: Maximum number of niche markets example: 1 sellerCountry: type: string description: 'Seller country code, comma-separated for multiple countries, e.g.: CN,US' required: - asin example: asin: B072MQ5BRX countryCode: US pageSize: 10 page: 1 additionalProperties: true example: asin: B072MQ5BRX countryCode: US pageSize: 10 page: 1 responses: '200': description: Successful response. content: application/json: schema: type: object description: Returns the documented upstream API response directly without an additional wrapper. properties: total: type: integer description: Total record count example: 1 pages: type: integer description: Total page count example: 1 page: type: integer description: Current page example: 1 pageSize: type: integer description: Page size, min 10, max 100 example: 10 data: type: array items: type: object properties: asin: type: string description: Amazon product ASIN example: B072MQ5BRX parentAsin: type: string description: Amazon product parent ASIN example: B072MQ5BRX title: type: string description: Product title brand: type: string description: Brand price: type: number description: Price example: 1 currentPrice: type: number description: Current price example: 1 currency: type: string description: Currency customerRating: type: number description: Rating example: 1 totalReviews: type: integer description: Review count example: 1 launchDate: type: string description: Listing time example: '2026-01-01' link: type: string description: ASIN link imagesUrl: type: string description: Product main image example: https://example.com/image.jpg sellerName: type: string description: Seller name sellerId: type: string description: Seller ID example: example-id fbaFee: type: number description: FBA fee example: 1 shippingFee: type: number description: FBA shipping fee example: 1 gpm: type: number description: Gross profit margin example: 1 clickConversionRate: type: number description: Click conversion rate (original 7-day click conversion rate) example: 1 clickConversionRateComposite: type: number description: Composite click conversion rate example: 1 clickConversionRateType: type: string description: Conversion rate calculation type clickConversionRateCompositeType: type: string description: Composite conversion rate calculation type clickCountT7: type: integer description: 7-day click count example: 1 clickCountT30: type: integer description: 30-day click count example: 1 clickCountT90: type: integer description: 90-day click count example: 1 clickCountGrowthT7: type: number description: Weekly click growth rate example: 1 clickCountGrowthT30: type: number description: Monthly click growth rate example: 1 purchasedClicksT360: type: integer description: 360-day purchase clicks example: 1 salesVolumeT360: type: integer description: Annual sales volume example: 1 nicheCount: type: integer description: Number of niche markets the product belongs to example: 1 sameNicheTitle: type: string description: Same niche title involvedNum: type: integer description: Number of involved keywords example: 1 involvedFrequency: type: integer description: Frequency of involved keywords example: 1 categoryNames: type: array items: {} description: Category information example: [] hasMetric: type: boolean description: Whether the product has metrics example: false searchValueType: type: string description: 'Search type: exact (exact match), sameNiche (same niche as reference ASIN), category (category)' niches: type: array items: {} description: 'Top 3 niche markets, containing: nicheId, nicheTitle, demand (market score), image, marketplaceId' example: [] bestSellersRanking: type: array items: {} description: 'Best seller rankings, containing: rank (ranking), category (category name)' example: [] trends: type: array items: {} description: '90-day trend data, containing: day (date), clickCountT7 (weekly click count), reviewCount (review count), reviewRating (review rating), bestSellerRanking (BSR ranking), averagePriceT7 (weekly average price), totalOfferDepthT7 (7-day new offers)' example: [] lastUpdateTime: type: string description: Last update time example: '2026-01-01' additionalProperties: true description: ASIN product list (see product object fields below) example: [] columns: type: array items: {} description: Rendered columns example: [] type: type: string description: Render style costToken: type: integer description: Token consumption example: 1 errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. message: type: string description: Provider-specific message. title: type: string description: Provider-specific response title. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. costTime: type: integer description: Execution time reported by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. example: total: 1 pages: 1 page: 1 pageSize: 10 data: - asin: B072MQ5BRX parentAsin: B072MQ5BRX price: 1 currentPrice: 1 customerRating: 1 totalReviews: 1 launchDate: '2026-01-01' imagesUrl: https://example.com/image.jpg sellerId: example-id fbaFee: 1 shippingFee: 1 gpm: 1 clickConversionRate: 1 clickConversionRateComposite: 1 clickCountT7: 1 clickCountT30: 1 clickCountT90: 1 clickCountGrowthT7: 1 clickCountGrowthT30: 1 purchasedClicksT360: 1 salesVolumeT360: 1 nicheCount: 1 involvedNum: 1 involvedFrequency: 1 categoryNames: [] hasMetric: false niches: [] bestSellersRanking: [] trends: [] lastUpdateTime: '2026-01-01' columns: [] costToken: 1 additionalProperties: true example: total: 1 pages: 1 page: 1 pageSize: 10 data: - asin: B072MQ5BRX parentAsin: B072MQ5BRX price: 1 currentPrice: 1 customerRating: 1 totalReviews: 1 launchDate: '2026-01-01' imagesUrl: https://example.com/image.jpg sellerId: example-id fbaFee: 1 shippingFee: 1 gpm: 1 clickConversionRate: 1 clickConversionRateComposite: 1 clickCountT7: 1 clickCountT30: 1 clickCountT90: 1 clickCountGrowthT7: 1 clickCountGrowthT30: 1 purchasedClicksT360: 1 salesVolumeT360: 1 nicheCount: 1 involvedNum: 1 involvedFrequency: 1 categoryNames: [] hasMetric: false niches: [] bestSellersRanking: [] trends: [] lastUpdateTime: '2026-01-01' columns: [] costToken: 1 '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: amazon-related-asins x-nexscope-mcp-tool-name: nexscope_amazon_related_asins x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/amazon-reviews-list/run: post: tags: - Amazon Marketplace Intelligence summary: Amazon Reviews List description: Fetch and analyze Amazon product reviews by ASIN, supporting 15 marketplaces (including US) with star rating filtering. Triggered when users mention Amazon reviews, US reviews, product reviews, buyer complaints, negative reviews, positive reviews, star ratings, review analysis, review sentiment, product improvement suggestions, Vine reviews, verified purchase reviews, competitor review research, Amazon reviews, US reviews, Amazon.com reviews, product feedback, negative review analysis, positive review analysis, star rating filter, review sentiment analysis, product improvement insights, Vine reviews, competitor reviews, customer feedback. Even if users do not explicitly say "reviews", this skill should be triggered whenever the task involves reading, filtering, or analyzing Amazon product customer reviews. operationId: runAmazonReviewsList externalDocs: description: Amazon Reviews List documentation url: https://www.nexscope.ai/api-docs/amazon-reviews-list requestBody: required: true content: application/json: schema: type: object description: Request parameters documented by ecommerce.amazon-reviews-list. properties: asin: type: string description: Amazon product ASIN example: B072MQ5BRX domainCode: type: string description: 'Amazon domain code, default com. Options: com, ca, co.uk, in, de, fr, it, es, co.jp, com.au, com.br, nl, se, com.mx, ae. Use com for the US site' star1Num: type: integer description: Number of 1-star reviews, default 10, max 100 example: 1 star2Num: type: integer description: Number of 2-star reviews, default 10, max 100 example: 1 star3Num: type: integer description: Number of 3-star reviews, default 10, max 100 example: 1 star4Num: type: integer description: Number of 4-star reviews, default 10, max 100 example: 1 star5Num: type: integer description: Number of 5-star reviews, default 10, max 100 example: 1 filterByKeyword: type: string description: Filter reviews by keyword, max length 1000 characters example: phone case sortBy: type: string description: 'Review sort order: recent (most recent reviews) or helpful (most helpful reviews), default recent' reviewerType: type: string description: 'Reviewer type: all_reviews (all reviews) or avp_only_reviews (verified purchases only), default all_reviews' mediaType: type: string description: 'Media type: all_contents (all content) or media_reviews_only (reviews with media only), default all_contents' formatType: type: string description: 'Format type: all_formats (all formats) or current_format (current format), default all_formats' required: - asin example: star4Num: 1 domainCode: com asin: B072MQ5BRX star5Num: 1 star1Num: 1 star2Num: 1 star3Num: 1 additionalProperties: true example: star4Num: 1 domainCode: com asin: B072MQ5BRX star5Num: 1 star1Num: 1 star2Num: 1 star3Num: 1 responses: '200': description: Successful response. content: application/json: schema: type: object description: Returns the documented upstream API response directly without an additional wrapper. properties: total: type: integer description: Total review count example: 1 data: type: array items: {} description: Review list (see review object below) example: [] columns: type: array items: type: object properties: reviewId: type: string description: Review ID example: example-id asin: type: string description: Product ASIN example: B072MQ5BRX title: type: string description: Review title text: type: string description: Review content rating: type: string description: Rating date: type: string description: Review date example: '2026-01-01' userName: type: string description: Reviewer name verified: type: boolean description: Whether verified purchase example: false vine: type: boolean description: Whether Vine Voice review example: false numberOfHelpful: type: integer description: Helpful count example: 1 imageUrlList: type: array items: {} description: Review image list example: [] videoUrlList: type: array items: {} description: Review video list example: [] domainCode: type: string description: Country code productTitle: type: string description: Product title productRating: type: string description: Product rating countRatings: type: integer description: Product rating count example: 1 countReviews: type: integer description: Product review count example: 1 variationId: type: string description: Variation ID example: example-id variationList: type: array items: {} description: Variation list example: [] profilePath: type: string description: Reviewer profile path currentPage: type: integer description: Current page number example: 1 sortStrategy: type: string description: Sort strategy statusCode: type: integer description: Status code example: 1 statusMessage: type: string description: Status message locale: type: object description: Locale information example: {} properties: {} additionalProperties: true reviewSummary: type: object description: Review summary data example: {} properties: {} additionalProperties: true filters: type: object description: Applied filter conditions example: {} properties: {} additionalProperties: true additionalProperties: true description: Rendered columns example: [] costToken: type: integer description: Total token consumption example: 1 type: type: string description: Render style errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. message: type: string description: Provider-specific message. title: type: string description: Provider-specific response title. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. example: total: 1 data: [] columns: - reviewId: example-id asin: B072MQ5BRX date: '2026-01-01' verified: false vine: false numberOfHelpful: 1 imageUrlList: [] videoUrlList: [] countRatings: 1 countReviews: 1 variationId: example-id variationList: [] currentPage: 1 statusCode: 1 locale: {} reviewSummary: {} filters: {} costToken: 1 additionalProperties: true example: total: 1 data: [] columns: - reviewId: example-id asin: B072MQ5BRX date: '2026-01-01' verified: false vine: false numberOfHelpful: 1 imageUrlList: [] videoUrlList: [] countRatings: 1 countReviews: 1 variationId: example-id variationList: [] currentPage: 1 statusCode: 1 locale: {} reviewSummary: {} filters: {} costToken: 1 '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: amazon-reviews-list x-nexscope-mcp-tool-name: nexscope_amazon_reviews_list x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/amazon-sales-estimates/run: post: tags: - Amazon Marketplace Intelligence summary: Amazon Sales Estimates description: Jungle Scout ASIN sales estimates query, returning daily estimated sales and latest known price for a specified ASIN over a given time period, covering 10 marketplaces including US, UK, Germany, and Japan. Triggered when users mention ASIN sales estimates, ASIN daily sales, sales estimation, competitor sales monitoring, average daily sales, sales trends, product sales tracking, Jungle Scout sales data, sales estimates, daily sales, estimated units sold, ASIN sales tracking, competitor sales monitoring, product sales trend, daily unit sales. Even if users do not explicitly mention "Jungle Scout", this skill should be triggered whenever the task involves viewing daily estimated sales data for an Amazon ASIN over a time period. operationId: runAmazonSalesEstimates externalDocs: description: Amazon Sales Estimates documentation url: https://www.nexscope.ai/api-docs/amazon-sales-estimates requestBody: required: true content: application/json: schema: type: object description: Request parameters documented by ecommerce.amazon-sales-estimates. properties: marketplace: type: string description: 'Target marketplace code. Options: us, uk, de, in, ca, fr, it, es, mx, jp' example: us asin: type: string description: Amazon ASIN to query example: B072MQ5BRX startDate: type: string description: 'Start date (format: YYYY-MM-DD)' example: '2026-01-01' endDate: type: string description: 'End date (format: YYYY-MM-DD); must be earlier than the current date' example: '2026-01-01' required: - marketplace - asin - startDate - endDate example: asin: B072MQ5BRX marketplace: us endDate: '2026-01-01' startDate: '2026-01-01' additionalProperties: true example: asin: B072MQ5BRX marketplace: us endDate: '2026-01-01' startDate: '2026-01-01' responses: '200': description: Successful response. content: application/json: schema: type: object description: Returns the documented upstream API response directly without an additional wrapper. properties: costToken: type: integer description: Token consumption example: 1 salesEstimateList: type: array items: type: object properties: asin: type: string description: Queried ASIN example: B072MQ5BRX id: type: string description: Data point identifier example: example-id type: type: string description: Resource type, fixed value sales_estimate_result parentAsin: type: string description: Parent ASIN (returned for variant scenarios) example: B072MQ5BRX isParent: type: boolean description: Whether it is a parent listing example: false isVariant: type: boolean description: Whether it is a variant listing example: false isStandalone: type: boolean description: Whether it is a standalone listing (non-variant) example: false variants: type: array items: {} description: Array of variant ASINs under this parent example: [] dailyEstimates: type: array items: {} description: Array of daily estimate data example: [] date: type: string description: Data date (YYYY-MM-DD) example: '2026-01-01' estimatedUnitsSold: type: integer description: Estimated units sold on that day example: 1 lastKnownPrice: type: number description: Last known price (USD) example: 1 additionalProperties: true description: Sales estimate result list example: [] errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. message: type: string description: Provider-specific message. type: type: string description: Provider-specific render or payload type. title: type: string description: Provider-specific response title. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. example: costToken: 1 salesEstimateList: - asin: B072MQ5BRX id: example-id parentAsin: B072MQ5BRX isParent: false isVariant: false isStandalone: false variants: [] dailyEstimates: [] date: '2026-01-01' estimatedUnitsSold: 1 lastKnownPrice: 1 additionalProperties: true example: costToken: 1 salesEstimateList: - asin: B072MQ5BRX id: example-id parentAsin: B072MQ5BRX isParent: false isVariant: false isStandalone: false variants: [] dailyEstimates: [] date: '2026-01-01' estimatedUnitsSold: 1 lastKnownPrice: 1 '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: amazon-sales-estimates x-nexscope-mcp-tool-name: nexscope_amazon_sales_estimates x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/amazon-search/run: post: tags: - Amazon Marketplace Intelligence summary: Amazon Search description: Simulates a real user searching on Amazon's storefront to get real-time keyword ranking and search results page data. Use when the user mentions Amazon product search, search result scraping, keyword ranking on search pages, ASIN ranking position check, competitor discovery, search page price comparison, sponsored product analysis, new product monitoring, or storefront search simulation. Even if the user does not explicitly mention "search simulation", trigger this skill whenever their need involves real-time Amazon search results, product ranking data, or storefront SERP analysis. operationId: runAmazonSearch externalDocs: description: Amazon Search documentation url: https://www.nexscope.ai/api-docs/amazon-search requestBody: required: true content: application/json: schema: type: object description: Request parameters documented by ecommerce.amazon-search. properties: keyword: type: string description: Keyword; please translate to the language of the target country whenever possible, e.g., use English keywords for the US, German keywords for Germany, etc. (max length 1024) example: phone case amazonDomain: type: string description: Amazon country site, default amazon.com node: type: string description: Amazon category node (max length 1000) language: type: string description: Language/region code, e.g., en_US, de_DE, ja_JP, fr_FR (max length 1000) sort: type: string description: 'Sort order: relevanceblender (Featured, default), price-asc-rank (Price low to high), price-desc-rank (Price high to low), review-rank (Avg. customer review), date-desc-rank (Newest arrivals), exact-aware-popularity-rank (Best sellers)' page: type: integer description: Page number (starting from 1, ~20 items per page), default 1 example: 1 deliveryZip: type: string description: Delivery zip code, used to simulate Amazon frontend address. It is recommended to use commonly used zip codes for major cities in the target country, e.g., New York zip code 10001 for the US site (max length 1000) device: type: string description: 'Device type: desktop, mobile, tablet, default desktop (max length 1000)' example: page: 1 keyword: phone case additionalProperties: true example: page: 1 keyword: phone case responses: '200': description: Successful response. content: application/json: schema: type: object description: Returns the documented upstream API response directly without an additional wrapper. properties: total: type: integer description: Total rows example: 1 keyword: type: string description: Search keyword example: phone case type: type: string description: Render style columns: type: array items: {} description: Rendered column definitions example: [] costToken: type: integer description: Token consumption example: 1 products: type: array items: type: object properties: asin: type: string description: ASIN example: B072MQ5BRX title: type: string description: Title brand: type: string description: Brand price: type: number description: Price example: 1 extractedPrice: type: number description: Parsed price example: 1 oldPrice: type: number description: Strikethrough price example: 1 extractedOldPrice: type: number description: Parsed strikethrough price example: 1 currency: type: string description: Currency priceUnit: type: string description: Price unit extractedPriceUnit: type: number description: Parsed price unit example: 1 rating: type: number description: Rating example: 1 ratings: type: integer description: Number of ratings example: 1 position: type: integer description: Position example: 1 sponsored: type: boolean description: Whether sponsored example: false imageUrl: type: string description: Thumbnail example: https://example.com/image.jpg asinUrl: type: string description: Link example: B072MQ5BRX delivery: type: string description: Delivery information fulfillment: type: string description: Fulfillment information (e.g., FBA) availableDate: type: string description: Listing time example: '2026-01-01' monthlySalesUnits: type: integer description: Monthly sales units example: 1 monthlySalesRevenue: type: string description: Monthly sales revenue sellerNation: type: string description: Seller nationality dimension: type: string description: Dimensions weight: type: string description: Weight options: type: string description: Options offers: type: string description: Offer information badges: type: string description: Amazon frontend search badges tags: type: string description: Tags snapEbtEligible: type: boolean description: SNAP/EBT eligibility example: false sourceType: type: string description: 'Source type: amazon' sourceTool: type: string description: Source tool keyword: type: string description: Keyword example: phone case additionalProperties: true description: Search result list (see below) example: [] errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. message: type: string description: Provider-specific message. title: type: string description: Provider-specific response title. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. example: total: 1 keyword: phone case columns: [] costToken: 1 products: - asin: B072MQ5BRX price: 1 extractedPrice: 1 oldPrice: 1 extractedOldPrice: 1 extractedPriceUnit: 1 rating: 1 ratings: 1 position: 1 sponsored: false imageUrl: https://example.com/image.jpg asinUrl: B072MQ5BRX availableDate: '2026-01-01' monthlySalesUnits: 1 snapEbtEligible: false keyword: phone case additionalProperties: true example: total: 1 keyword: phone case columns: [] costToken: 1 products: - asin: B072MQ5BRX price: 1 extractedPrice: 1 oldPrice: 1 extractedOldPrice: 1 extractedPriceUnit: 1 rating: 1 ratings: 1 position: 1 sponsored: false imageUrl: https://example.com/image.jpg asinUrl: B072MQ5BRX availableDate: '2026-01-01' monthlySalesUnits: 1 snapEbtEligible: false keyword: phone case '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: amazon-search x-nexscope-mcp-tool-name: nexscope_amazon_search x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/amazon-search-by-image/run: post: tags: - Amazon Marketplace Intelligence summary: Amazon Search By Image description: Perform image-based visual product search on Amazon across 8 marketplaces. Use an image URL to find visually similar products, with optional Keepa enrichment for sales data. Triggered when users mention Amazon image search, Amazon visual search, find similar products on Amazon, reverse image lookup Amazon, Amazon search by photo, or competitor image search. Even if the user does not explicitly mention "image search," this skill should be triggered whenever a user provides an image URL and wants to find visually matching or similar products on Amazon. operationId: runAmazonSearchByImage externalDocs: description: Amazon Search By Image documentation url: https://www.nexscope.ai/api-docs/amazon-search-by-image requestBody: required: true content: application/json: schema: type: object description: Request parameters documented by ecommerce.amazon-search-by-image. properties: imageUrl: type: string description: Valid, publicly accessible image URL (maximum 1,000 characters) example: https://m.media-amazon.com/images/I/31SkgVLWSuL._SL75_.jpg amazonDomain: type: string description: 'Amazon marketplace. Supported domains: United States (amazon.com), United Kingdom (amazon.co.uk), Germany (amazon.de), France (amazon.fr), Italy (amazon.it), Spain (amazon.es), Japan (amazon.co.jp), and India (amazon.in). Default: amazon.com' example: amazon.com sort: type: string description: 'Sort by price, rating, or rating count. Values: default, price-asc-rank, price-desc-rank, rating-asc-rank, rating-desc-rank, ratings-asc-rank, and ratings-desc-rank' deliveryZip: type: string description: 'Delivery postal code or city within the selected marketplace. If omitted, the marketplace default is used. Maximum 1,000 characters. Defaults: United States=10001, United Kingdom=EC1A 1BB, Germany=10115, France=75001, Italy=00100, Spain=28001, Japan=100-0001, and India=110034' countryOrAreaCode: type: string description: Destination country or region code for cross-border delivery, such as CN, JP, KR, TW, HK, MO, SG, TH, VN, PH, or MY. Do not provide this together with deliveryZip. Amazon India does not support cross-border destination settings. Maximum 1,000 characters aggregateByKeepaData: type: boolean description: Whether to enrich results with Keepa data such as sales rank, monthly sales, FBA fees, and dimensions example: false required: - imageUrl - amazonDomain example: aggregateByKeepaData: false amazonDomain: amazon.com imageUrl: https://m.media-amazon.com/images/I/31SkgVLWSuL._SL75_.jpg additionalProperties: true example: aggregateByKeepaData: false amazonDomain: amazon.com imageUrl: https://m.media-amazon.com/images/I/31SkgVLWSuL._SL75_.jpg responses: '200': description: Successful response. content: application/json: schema: type: object description: Returns the documented upstream API response directly without an additional wrapper. properties: total: type: integer description: Total rows example: 1 totalCount: type: integer description: Total count example: 1 perPage: type: integer description: Items per page example: 1 currentPage: type: integer description: Current page example: 1 type: type: string description: Rendering style sourceType: type: string description: Source type columns: type: array items: {} description: Column definitions used for rendering example: [] costToken: type: integer description: Tokens consumed example: 1 products: type: array items: type: object properties: currency: type: string description: Currency brand: type: string description: Brand fulfillment: type: string description: 'Fulfillment method from Keepa: AMZ, FBA, or FBM' manufacturer: type: string description: Manufacturer from Keepa model: type: string description: Model from Keepa color: type: string description: Color from Keepa material: type: string description: Primary materials used in the product construction, from Keepa weight: type: string description: Weight in grams from Keepa dimension: type: string description: Dimensions from Keepa packageWeight: type: string description: Package weight in grams from Keepa packageDimensions: type: string description: Package dimensions from Keepa dimensionsType: type: string description: Dimension type from Keepa categoryTree: type: string description: Category tree from Keepa description: Product list; see the product fields below example: [] asin: type: string description: ASIN example: B072MQ5BRX title: type: string description: Product title imageUrl: type: string description: Image URL example: https://example.com/image.jpg asinUrl: type: string description: Amazon ASIN detail URL example: B072MQ5BRX price: type: number description: Current price in the marketplace currency example: 1 oldPrice: type: number description: List price example: 1 rating: type: number description: Current rating from 0.0 to 5.0 example: 1 ratings: type: integer description: Rating count example: 1 sourceTool: type: string description: Source tool salesRank: type: integer description: Sales rank from Keepa example: 1 salesRank30: type: integer description: Average sales rank over the past 30 days from Keepa example: 1 salesRank90: type: integer description: Average sales rank over the past 90 days from Keepa example: 1 salesRank180: type: integer description: Average sales rank over the past 180 days from Keepa example: 1 monthlySalesUnits: type: integer description: Monthly units sold from Keepa example: 1 monthlySalesRevenue: type: number description: Monthly sales revenue from Keepa example: 1 monthlySalesUnits1MonthAgo~monthlySalesUnits12MonthsAgo: type: integer description: Monthly sales from 1 through 12 months ago, from Keepa example: 1 reviewCount: type: integer description: Review count from Keepa example: 1 fbaFees: type: number description: FBA fulfillment fee in the marketplace currency from Keepa example: 1 profit: type: number description: Profit margin percentage from Keepa; for example, 25.5 means 25.5% example: 1 referralFeePercentage: type: number description: Referral fee percentage from Keepa example: 1 primePrice: type: number description: Prime price from Keepa example: 1 buyBoxSellerId: type: string description: Buy Box seller ID from Keepa example: example-id sellerNum: type: integer description: Seller count from Keepa example: 1 variationNum: type: integer description: Variation count from Keepa example: 1 parentAsin: type: string description: Parent ASIN from Keepa example: B072MQ5BRX availableDate: type: string description: Listing date from Keepa in yyyy-MM-dd HH:mm:ss format example: '2026-01-01' lastUpdate: type: string description: Last update time from Keepa in yyyy-MM-dd HH:mm:ss format example: '2026-01-01' itemLength: type: integer description: Product length in millimeters from Keepa; 0 or -1 when unavailable example: 1 itemWidth: type: integer description: Product width in millimeters from Keepa; 0 or -1 when unavailable example: 1 itemHeight: type: integer description: Product height in millimeters from Keepa; 0 or -1 when unavailable example: 1 packageLength: type: integer description: Package length in millimeters from Keepa example: 1 packageWidth: type: integer description: Package width in millimeters from Keepa example: 1 packageHeight: type: integer description: Package height in millimeters from Keepa example: 1 packageQuantity: type: integer description: Number of items in the package from Keepa; 0 or -1 when unavailable example: 1 categoryTreeId: type: string description: Category tree ID from Keepa example: example-id rootCategory: type: integer description: Root category ID from Keepa example: 1 isAdultProduct: type: boolean description: Whether the product is classified as adult content by Keepa example: false isHazmat: type: boolean description: Whether the product is classified as hazardous by Keepa example: false urlSlug: type: string description: URL slug from Keepa example: https://example.com/image.jpg productImageUrls: type: array items: {} description: Product image URLs from Keepa example: [] errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. message: type: string description: Provider-specific message. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. example: total: 1 totalCount: 1 perPage: 1 currentPage: 1 columns: [] costToken: 1 products: [] asin: B072MQ5BRX imageUrl: https://example.com/image.jpg asinUrl: B072MQ5BRX price: 1 oldPrice: 1 rating: 1 ratings: 1 salesRank: 1 salesRank30: 1 salesRank90: 1 salesRank180: 1 monthlySalesUnits: 1 monthlySalesRevenue: 1 monthlySalesUnits1MonthAgo~monthlySalesUnits12MonthsAgo: 1 reviewCount: 1 fbaFees: 1 profit: 1 referralFeePercentage: 1 primePrice: 1 buyBoxSellerId: example-id sellerNum: 1 variationNum: 1 parentAsin: B072MQ5BRX availableDate: '2026-01-01' lastUpdate: '2026-01-01' itemLength: 1 itemWidth: 1 itemHeight: 1 packageLength: 1 packageWidth: 1 packageHeight: 1 packageQuantity: 1 categoryTreeId: example-id rootCategory: 1 isAdultProduct: false isHazmat: false urlSlug: https://example.com/image.jpg productImageUrls: [] additionalProperties: true example: total: 1 totalCount: 1 perPage: 1 currentPage: 1 columns: [] costToken: 1 products: [] asin: B072MQ5BRX imageUrl: https://example.com/image.jpg asinUrl: B072MQ5BRX price: 1 oldPrice: 1 rating: 1 ratings: 1 salesRank: 1 salesRank30: 1 salesRank90: 1 salesRank180: 1 monthlySalesUnits: 1 monthlySalesRevenue: 1 monthlySalesUnits1MonthAgo~monthlySalesUnits12MonthsAgo: 1 reviewCount: 1 fbaFees: 1 profit: 1 referralFeePercentage: 1 primePrice: 1 buyBoxSellerId: example-id sellerNum: 1 variationNum: 1 parentAsin: B072MQ5BRX availableDate: '2026-01-01' lastUpdate: '2026-01-01' itemLength: 1 itemWidth: 1 itemHeight: 1 packageLength: 1 packageWidth: 1 packageHeight: 1 packageQuantity: 1 categoryTreeId: example-id rootCategory: 1 isAdultProduct: false isHazmat: false urlSlug: https://example.com/image.jpg productImageUrls: [] '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: amazon-search-by-image x-nexscope-mcp-tool-name: nexscope_amazon_search_by_image x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/reverse-product-image-search/run: post: tags: - Amazon Marketplace Intelligence summary: Reverse Product Image Search description: Runs the server-side image-search and enrichment workflow without exposing local file paths or intermediate artifacts. operationId: runReverseProductImageSearch externalDocs: description: Reverse Product Image Search documentation url: https://www.nexscope.ai/api-docs/reverse-product-image-search requestBody: required: true content: application/json: schema: type: object description: The backend manages intermediate workflow data; do not send local file paths. properties: imageUrl: type: string description: Publicly accessible product image URL. example: https://m.media-amazon.com/images/I/31SkgVLWSuL._SL75_.jpg amazonDomain: type: string description: Amazon marketplace domain. example: amazon.com topN: type: integer description: Maximum number of ranked matches to return after enrichment. example: 20 sort: type: string description: Optional provider sort mode. example: rating-desc-rank required: - imageUrl - amazonDomain example: topN: 20 amazonDomain: amazon.com imageUrl: https://m.media-amazon.com/images/I/31SkgVLWSuL._SL75_.jpg additionalProperties: true example: topN: 20 amazonDomain: amazon.com imageUrl: https://m.media-amazon.com/images/I/31SkgVLWSuL._SL75_.jpg responses: '200': description: Successful response. content: application/json: schema: type: object description: Returns ranked visual matches without local-file or intermediate-script output. properties: query: type: object description: Normalized image-search query. example: {} properties: {} additionalProperties: true matches: type: array items: type: object properties: rank: type: integer description: Backend-normalized result rank. example: 1 asin: type: string description: Amazon product ASIN. example: B072MQ5BRX title: type: string description: Product title. example: Example product imageUrl: type: string description: Matched product image URL. example: https://example.com/image.jpg price: type: number description: Current marketplace price. example: 29.99 rating: type: number description: Amazon rating. example: 4.5 estimatedMonthlySales: type: integer description: Provider-estimated monthly sales when available. example: 1200 additionalProperties: true description: Visually similar Amazon products, optionally enriched with marketplace metrics. example: [] caveats: type: array items: {} description: Limits on image similarity and provider estimates. example: [] errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. message: type: string description: Provider-specific message. type: type: string description: Provider-specific render or payload type. title: type: string description: Provider-specific response title. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. costToken: type: integer description: Token cost reported by the upstream provider. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. required: - query - matches example: query: {} matches: - rank: 1 asin: B072MQ5BRX title: Example product imageUrl: https://example.com/image.jpg price: 29.99 rating: 4.5 estimatedMonthlySales: 1200 caveats: [] additionalProperties: true example: query: {} matches: - rank: 1 asin: B072MQ5BRX title: Example product imageUrl: https://example.com/image.jpg price: 29.99 rating: 4.5 estimatedMonthlySales: 1200 caveats: [] '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: reverse-product-image-search x-nexscope-mcp-tool-name: nexscope_reverse_product_image_search x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/walmart-product-detail/run: post: tags: - Amazon Marketplace Intelligence summary: Walmart Product Detail description: Query Walmart product details via WallySmarter, including pricing history and sales trends. operationId: runWalmartProductDetail externalDocs: description: Walmart Product Detail documentation url: https://www.nexscope.ai/api-docs/walmart-product-detail requestBody: required: true content: application/json: schema: type: object description: Request parameters documented by ecommerce.walmart-product-detail. properties: productId: type: - integer - string description: 'Product ID (ItemId), the numeric ID contained in the product detail link. For example: the 5169493923 in https://www.walmart.com/ip/5169493923' example: '5169493923' includeStats: type: boolean description: Whether to include historical price/historical sales, default true example: false required: - productId example: includeStats: false productId: '5169493923' additionalProperties: true example: includeStats: false productId: '5169493923' responses: '200': description: Successful response. content: application/json: schema: type: object description: Returns the documented upstream API response directly without an additional wrapper. properties: code: type: string description: Return code ("200" indicates success) msg: type: string description: Message ("ok" on success, error description on failure) total: type: integer description: Number of products returned (typically 1 for this endpoint) example: 1 products: type: array items: type: object properties: usItemId: type: integer description: Internal product ID (same as the requested productId) example: 1 productId: type: string description: Walmart product unique identifier (alphanumeric, e.g., "6YBM50F6ZXAE") example: example-id title: type: string description: Product name description: type: string description: Product description price: type: number description: Current selling price (USD) example: 1 wasPrice: type: number description: Striketrough price (USD), may be null when no discount example: 1 minPrice: type: number description: Minimum price (USD) example: 1 brand: type: string description: Brand name rating: type: number description: Product rating (0.0-5.0) example: 1 reviews: type: integer description: Review count example: 1 salesEstimate: type: integer description: Sales estimate (units, in recent period) example: 1 revenue: type: number description: Revenue estimate (USD) example: 1 sellerName: type: string description: Seller name fulfillmentType: type: string description: 'Fulfillment type: "MARKETPLACE" (third-party seller self-fulfilled) or "WFS" (Walmart Fulfillment Services)' productPageUrl: type: string description: Product page URL example: https://example.com/image.jpg imageUrl: type: string description: Product image URL (thumbnail) example: https://example.com/image.jpg departmentName: type: string description: Department name (e.g., "Cell Phones") departmentId: type: integer description: Department ID example: 1 listingScore: type: integer description: Listing quality score example: 1 contentScore: type: integer description: Content quality score example: 1 outOfStock: type: integer description: Whether out of stock (0=in stock, 1=out of stock) example: 1 sponsored: type: integer description: Whether a sponsored product (0=no, 1=yes) example: 1 isBranded: type: integer description: Whether a branded product (0=no, 1=yes) example: 1 multipleOptionsAvailable: type: integer description: Whether there are variants (0=no, 1=yes) example: 1 createdAt: type: string description: 'First indexed time by WallySmarter (format: yyyy-MM-dd''T''HH:mm:ss.SSSSSS''Z'')' updatedAt: type: string description: Most recent data update time (same format as above) example: '2026-01-01' stats: type: object description: Historical statistics (only returned when includeStats=true, otherwise null. See structure below) example: {} properties: {} additionalProperties: true sourceTool: type: string description: Source tool identifier sourceType: type: string description: Product source platform (fixed value "walmart") additionalProperties: true description: Product list (see product object below) example: [] columns: type: array items: {} description: Column definitions (metadata describing each field in products, including field, title, cellType, etc.) example: [] type: type: string description: Response render type (fixed value "productWorkbenches") costTime: type: integer description: API elapsed time (milliseconds) example: 1 costToken: type: integer description: Token cost example: 1 stats: type: object properties: price: type: array items: {} description: Historical selling price time series (sorted by date ascending). Each item is a single date-price mapping example: [] sales: type: array items: {} description: Historical sales time series (sorted by date ascending). Each item is a single date-sales mapping example: [] additionalProperties: true errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. message: type: string description: Provider-specific message. title: type: string description: Provider-specific response title. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. example: total: 1 products: - usItemId: 1 productId: example-id price: 1 wasPrice: 1 minPrice: 1 rating: 1 reviews: 1 salesEstimate: 1 revenue: 1 productPageUrl: https://example.com/image.jpg imageUrl: https://example.com/image.jpg departmentId: 1 listingScore: 1 contentScore: 1 outOfStock: 1 sponsored: 1 isBranded: 1 multipleOptionsAvailable: 1 updatedAt: '2026-01-01' stats: {} columns: [] costTime: 1 costToken: 1 stats: price: [] sales: [] additionalProperties: true example: total: 1 products: - usItemId: 1 productId: example-id price: 1 wasPrice: 1 minPrice: 1 rating: 1 reviews: 1 salesEstimate: 1 revenue: 1 productPageUrl: https://example.com/image.jpg imageUrl: https://example.com/image.jpg departmentId: 1 listingScore: 1 contentScore: 1 outOfStock: 1 sponsored: 1 isBranded: 1 multipleOptionsAvailable: 1 updatedAt: '2026-01-01' stats: {} columns: [] costTime: 1 costToken: 1 stats: price: [] sales: [] '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: walmart-product-detail x-nexscope-mcp-tool-name: nexscope_walmart_product_detail x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/walmart-search/run: post: tags: - Amazon Marketplace Intelligence summary: Walmart Search description: Search and browse Walmart product listings by keyword, category, price range, and other conditions. operationId: runWalmartSearch externalDocs: description: Walmart Search documentation url: https://www.nexscope.ai/api-docs/walmart-search requestBody: required: true content: application/json: schema: type: object description: Request parameters documented by ecommerce.walmart-search. properties: keyword: type: string description: Search keyword, max length 1024 characters. *At least one of keyword and categoryId must be provided example: phone case categoryId: type: string description: 'Category ID. *At least one of keyword and categoryId must be provided. 0 means all departments. For example: 976759_976787 means "Cookies"' example: '976759_976787' sort: type: string description: 'Sort method. Options: price_low (price low to high), price_high (price high to low), best_seller (best seller), best_match (best match)' page: type: integer description: Page number for pagination, default 1, max 100 example: 1 minPrice: type: number description: Minimum price example: 1 maxPrice: type: number description: Maximum price example: 1 spelling: type: boolean description: Enable spelling correction, default true. true includes spelling correction, false excludes it example: false softSort: type: boolean description: Sort by relevance, default true. Set to false to disable relevance sorting example: false storeId: type: string description: Store ID, used to filter products by a specific store example: example-id device: type: string description: 'Device type, default desktop. Options: desktop, tablet, mobile' facet: type: string description: Filter conditions, format as key:value pairs separated by \ nextDayEnabled: type: boolean description: Only show NextDay delivery results, default false. true to enable, false to disable example: false jsonRestrictor: type: string description: JSON field restrictor example: page: 1 keyword: phone case spelling: true additionalProperties: true example: page: 1 keyword: phone case spelling: true responses: '200': description: Successful response. content: application/json: schema: type: object description: Returns the documented upstream API response directly without an additional wrapper. properties: total: type: integer description: Record count example: 1 products: type: array items: type: object properties: productId: type: string description: Product ID example: example-id usItemId: type: string description: US item ID example: example-id title: type: string description: Title description: type: string description: Description price: type: number description: Price example: 1 wasPrice: type: number description: Original price (was_price) example: 1 currency: type: string description: Currency unit minPrice: type: number description: Minimum price example: 1 pricePerUnitAmount: type: string description: Price per unit amount pricePerUnit: type: string description: Price per unit rating: type: number description: Rating example: 1 reviews: type: integer description: Review count example: 1 sellerName: type: string description: Seller name sellerId: type: string description: Seller ID example: example-id imageUrl: type: string description: Thumbnail example: https://example.com/image.jpg productPageUrl: type: string description: Product page URL example: https://example.com/image.jpg sponsored: type: boolean description: Whether a sponsored product example: false outOfStock: type: boolean description: Whether out of stock example: false freeShipping: type: boolean description: Whether free shipping example: false twoDayShipping: type: boolean description: Whether two-day shipping supported example: false freeShippingWithWalmartPlus: type: boolean description: Free shipping for Walmart Plus members example: false shippingPrice: type: number description: Shipping cost example: 1 multipleOptionsAvailable: type: boolean description: Whether multiple options available example: false variantSwatches: type: array items: {} description: Variant swatch list (each item contains name variant name, imageUrl variant image URL, productPageUrl variant product page URL, variantFieldId variant field ID) example: [] sourceTool: type: string description: Source tool sourceType: type: string description: 'Source type: walmart' additionalProperties: true description: Product list (see product object below) example: [] columns: type: array items: {} description: Rendered columns example: [] type: type: string description: Render style costToken: type: integer description: Token cost example: 1 errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. message: type: string description: Provider-specific message. title: type: string description: Provider-specific response title. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. example: total: 1 products: - productId: example-id usItemId: example-id price: 1 wasPrice: 1 minPrice: 1 rating: 1 reviews: 1 sellerId: example-id imageUrl: https://example.com/image.jpg productPageUrl: https://example.com/image.jpg sponsored: false outOfStock: false freeShipping: false twoDayShipping: false freeShippingWithWalmartPlus: false shippingPrice: 1 multipleOptionsAvailable: false variantSwatches: [] columns: [] costToken: 1 additionalProperties: true example: total: 1 products: - productId: example-id usItemId: example-id price: 1 wasPrice: 1 minPrice: 1 rating: 1 reviews: 1 sellerId: example-id imageUrl: https://example.com/image.jpg productPageUrl: https://example.com/image.jpg sponsored: false outOfStock: false freeShipping: false twoDayShipping: false freeShippingWithWalmartPlus: false shippingPrice: 1 multipleOptionsAvailable: false variantSwatches: [] columns: [] costToken: 1 '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: walmart-search x-nexscope-mcp-tool-name: nexscope_walmart_search x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/amazon-alexa-search/run: post: tags: - Amazon Marketplace Intelligence summary: Amazon Alexa Search description: Initiate natural language Q&A through Amazon's storefront Alexa shopping assistant to get shopping guidance answers, recommended product groups, ASIN lists, and follow-up questions. Each call supports only 1 prompt; for follow-ups, the agent must summarize context and concatenate a new question for a new request. A url can be used to supplement Amazon page context. operationId: runAmazonAlexaSearch externalDocs: description: Amazon Alexa Search documentation url: https://www.nexscope.ai/api-docs/amazon-alexa-search requestBody: required: true content: application/json: schema: type: object description: Request parameters documented by ecommerce.amazon-alexa-search. properties: prompts: type: array items: type: string description: Conversation prompt array, supports only 1 entry. Each call accepts only 1 question. For follow-up questions, the agent must summarize key information from the previous response (recommended products, ASINs, key conclusions, etc.), concatenate it with the new question, and send it as a new prompts[0]. Each call is an independent new session and does not retain cross-call conversation history example: - What are good phone cases for iPhone? format: type: string description: 'Response format: markdown (default) returns a readable report; json returns a structured data array' url: type: string description: Linked page URL, used to supplement the page context of Alexa's current response. Only pass this when the user provides a specific page (category page / search results page / product detail page, etc.); do not pass this parameter for the Amazon homepage (e.g. https://www.amazon.com/) example: https://example.com/image.jpg required: - prompts example: prompts: - What are good phone cases for iPhone? format: markdown additionalProperties: true example: prompts: - What are good phone cases for iPhone? format: markdown responses: '200': description: Successful response. content: application/json: schema: type: object description: Returns the documented upstream API response directly without an additional wrapper. properties: products: type: array items: type: object properties: stdout: type: string description: Markdown format Q&A report, containing each round's user question, Alexa answer, recommended products, and follow-up questions; only returned when format=markdown msg/errmsg: type: string description: Response message, ok on success title: type: string description: Recommended group title items: type: array items: type: object properties: asin: type: string description: Product ASIN example: B072MQ5BRX title: type: string description: Product title url: type: string description: Product detail page URL example: https://example.com/image.jpg cover: type: string description: Product cover image URL price: type: string description: Current price (with currency) originalPrice: type: string description: Original or strikethrough price score: type: string description: Rating ratingsCount: type: string description: Review count describe: type: string description: Product description additionalProperties: true additionalProperties: true data: type: array items: type: object properties: prompt: type: string description: Prompt sent to Alexa for this round content: type: string description: Text content of Alexa's response for this round screenshot: type: string description: Screenshot link for this round's conversation followUpQuestions: type: array items: {} description: List of follow-up questions recommended by Alexa example: [] products: type: array items: {} description: Recommended product group list, each group containing title and items example: [] additionalProperties: true description: Structured conversation result array; only returned when format=json example: [] resultsNum: type: integer description: Number of conversation rounds Alexa actually answered; 0 means no valid response was produced example: 1 code: type: string description: Business status code, "200" on success (same as numeric errcode) errcode: type: integer description: Business status code (HTTP layer is generally 200; use this field to determine business success/failure) example: 1 costTime: type: integer description: API latency in milliseconds example: 1 costToken: type: integer description: Tokens consumed by this call; charged only if upstream succeeds example: 1 taskId: type: string description: Task identifier returned by upstream example: example-id type: type: string description: 'Render style: stdoutWorkbenches (markdown) or json' errmsg: type: string description: Upstream status message returned by the provider. msg: type: string description: Provider-specific status message. message: type: string description: Provider-specific message. title: type: string description: Provider-specific response title. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. example: data: - followUpQuestions: [] products: [] resultsNum: 1 errcode: 1 costTime: 1 costToken: 1 taskId: example-id products: - items: - asin: B072MQ5BRX url: https://example.com/image.jpg additionalProperties: true example: data: - followUpQuestions: [] products: [] resultsNum: 1 errcode: 1 costTime: 1 costToken: 1 taskId: example-id products: - items: - asin: B072MQ5BRX url: https://example.com/image.jpg '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: amazon-alexa-search x-nexscope-mcp-tool-name: nexscope_amazon_alexa_search x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true components: responses: ServerError: description: Server or upstream provider error. content: application/json: schema: $ref: '#/components/schemas/CommonError' Forbidden: description: The account or API key is not allowed to use this capability. content: application/json: schema: $ref: '#/components/schemas/CommonError' Unauthorized: description: Missing or invalid API key. content: application/json: schema: $ref: '#/components/schemas/CommonError' TooManyRequests: description: Rate limit or account usage limit reached. headers: Retry-After: description: Retry delay when returned by the service. schema: type: integer content: application/json: schema: $ref: '#/components/schemas/CommonError' BadRequest: description: Invalid request parameters. content: application/json: schema: $ref: '#/components/schemas/CommonError' schemas: CommonError: type: object description: Common API error envelope. Exact fields may vary by endpoint and upstream provider. properties: code: oneOf: - type: integer - type: string description: Application or provider error code. msg: type: string description: Error message. message: type: string description: Alternative error message field. traceId: type: string description: Support trace identifier when available. additionalProperties: true securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: Nexscope API Key externalDocs: description: Nexscope API Documentation url: https://www.nexscope.ai/api-docs x-nexscope-source: https://api.nexscope.ai/api/skill-api/v1/api-docs x-nexscope-pricing-mode: dynamic-credits x-nexscope-mcp-endpoint: https://api.nexscope.ai/api/skill-api/v1/mcp