n8n-nodes-sellerassistant

This is an n8n community node. It lets you use Seller Assistant in your n8n workflows.

Seller Assistant is an Amazon product research tool that helps sellers analyze products, check restrictions, estimate sales, and calculate profitability.

n8n is a fair-code licensed workflow automation platform.

Installation Operations Credentials Compatibility Usage Resources

Installation

Follow the installation guide in the n8n community nodes documentation.

Operations

Converter

• ASIN to Identifiers - Get array of product identifiers (UPC, EAN, etc.) based on ASIN
• Identifier to ASINs - Get array of product ASINs based on UPC or EAN identifier

FBA Inbound

• Get Inbound Plan - Get detailed information about a specific FBA inbound plan
• Get Shipment - Get detailed information about a specific shipment
• Get Shipment Fees - Get transportation and placement fees for a specific shipment
• List Inbound Plans - Get a paginated list of FBA inbound plans with filtering and sorting options
• List Plan Boxes - Get all boxes across all shipments for a specific FBA inbound plan
• List Plan Shipments - Get all shipments for a specific FBA inbound plan
• List Shipment Boxes - Get all boxes for a specific shipment
• List Shipment Items - Get all items in a specific shipment

Keepa

• Get Product - Get detailed product info from Keepa including price history, statistics, and marketplace offers
• Product Finder - Search for products matching specified criteria with aggregated KPIs and insights
• Search Products - Search for Amazon products using keywords, returning up to 100 results per search term

Listings Items

• Search Listings Items - Search for listings items by identifiers (SKU, ASIN, EAN, UPC, etc.) with filtering and pagination
• Get Listings Item - Get a listings item by seller SKU with detailed information
• Create or Update Listing from ASIN - Create or update a listing by copying product data from an existing ASIN
• Delete Listings Item - Delete a listings item by seller SKU

Product

• Calculate Product Profit - Calculate product profit for FBA and FBM including ROI, margin, and break-even analysis
• Get Product Info - Retrieve detailed product information from Amazon by ASIN
• Get Product Statistics - Fetch detailed statistics for a product including monthly sales, prices, BSR, offers, reviews, and BSR drops count

Restriction

• Check ASIN Restrictions - Check if you are allowed to sell a product (returns ALLOWED_TO_SELL, NOT_ELIGIBLE, or APPROVAL_REQUIRED)

Sales

• Estimate by ASIN - Estimate approximate monthly sales number for a product by ASIN
• Estimate by BSR - Estimate approximate monthly sales number based on BSR and category

Credentials

To use this node, you need a Seller Assistant API key:

1. Sign up for a Seller Assistant account
2. Navigate to Settings > API Keys
3. Generate a new API key
4. In n8n, create new credentials for "Seller Assistant API" and paste your API key

Compatibility

• Requires n8n version 1.0.0 or later
• Tested with n8n versions 1.x

Usage

ASIN to Identifiers

Use the "ASIN to Identifiers" operation to get product identifiers (UPC, EAN, etc.) from an ASIN:

1. Add the Seller Assistant node to your workflow
2. Select "Converter" as the resource
3. Select "ASIN to Identifiers" as the operation
4. Enter the ASIN of the product
5. Select the Amazon marketplace domain
6. Execute the node to get product identifiers

Note: This operation requires an Amazon seller account integration. Connect your account at Seller Assistant Integrations.

The node returns an array of identifiers (UPC, EAN, etc.) for the product. Returns an empty array if no identifiers are found.

Identifier to ASINs

Use the "Identifier to ASINs" operation to convert a UPC or EAN to Amazon ASINs:

1. Add the Seller Assistant node to your workflow
2. Select "Converter" as the resource
3. Select "Identifier to ASINs" as the operation
4. Enter the UPC or EAN identifier
5. Select the Amazon marketplace domain
6. Execute the node to get matching ASINs

Note: This operation requires an Amazon seller account integration. Connect your account at Seller Assistant Integrations.

The node returns an array of ASINs that match the provided UPC or EAN. Returns an empty array if no products are found.

Get Inbound Plan

Use the "Get Inbound Plan" operation to retrieve detailed information about a specific FBA inbound plan:

1. Add the Seller Assistant node to your workflow
2. Select "FBA Inbound" as the resource
3. Select "Get Inbound Plan" as the operation
4. Enter the Inbound Plan ID (Workflow ID)
5. Select the Amazon marketplace domain
6. Execute the node to get inbound plan details

Note: This operation requires an Amazon seller account integration. Connect your account at Seller Assistant Integrations.

The node returns detailed inbound plan information including:

• Plan ID, name, and status
• Source address
• Creation and last updated timestamps
• Marketplace IDs
• Packing options with status
• Placement options with status
• Shipments list with IDs and status

Get Shipment

Use the "Get Shipment" operation to retrieve detailed information about a specific shipment:

1. Add the Seller Assistant node to your workflow
2. Select "FBA Inbound" as the resource
3. Select "Get Shipment" as the operation
4. Enter the Inbound Plan ID (Workflow ID)
5. Enter the Shipment ID (sh... or FBA... format)
6. Select the Amazon marketplace domain
7. Execute the node to get shipment details

Note: This operation requires an Amazon seller account integration. Connect your account at Seller Assistant Integrations.

The node returns detailed shipment information including:

• Shipment ID and status
• Amazon reference ID
• Source and destination addresses
• Contact information
• Tracking details (LTL and SPD)
• Delivery window information
• Freight information
• Self-ship appointment details

Get Shipment Fees

Use the "Get Shipment Fees" operation to retrieve transportation and placement fees for a specific shipment:

1. Add the Seller Assistant node to your workflow
2. Select "FBA Inbound" as the resource
3. Select "Get Shipment Fees" as the operation
4. Enter the Inbound Plan ID (Workflow ID)
5. Enter the Shipment ID (sh... or FBA... format)
6. Select the Amazon marketplace domain
7. Execute the node to get shipment fees

Note: This operation requires an Amazon seller account integration. Connect your account at Seller Assistant Integrations.

The node returns fee information including:

• Placement fees with discounts and status
• Transportation options with carrier info, shipping mode, and quotes
• Fee amounts and currency codes
• Expiration dates for quotes

List Inbound Plans

Use the "List Inbound Plans" operation to retrieve a paginated list of FBA inbound plans:

1. Add the Seller Assistant node to your workflow
2. Select "FBA Inbound" as the resource
3. Select "List Inbound Plans" as the operation
4. Select the Amazon marketplace domain
5. Optionally configure filtering options (status, sort by, sort order, page size)
6. Execute the node to get inbound plans

Note: This operation requires an Amazon seller account integration. Connect your account at Seller Assistant Integrations.

The node returns a list of inbound plans including:

• Plan ID and name
• Status (ACTIVE, VOIDED, SHIPPED)
• Source address
• Creation and last updated timestamps
• Marketplace IDs
• Pagination token for fetching additional pages

List Plan Boxes

Use the "List Plan Boxes" operation to retrieve all boxes across all shipments for a specific FBA inbound plan:

1. Add the Seller Assistant node to your workflow
2. Select "FBA Inbound" as the resource
3. Select "List Plan Boxes" as the operation
4. Enter the Inbound Plan ID (Workflow ID)
5. Select the Amazon marketplace domain
6. Optionally configure page size and pagination token
7. Execute the node to get boxes

Note: This operation requires an Amazon seller account integration. Connect your account at Seller Assistant Integrations.

The node returns box information including:

• Box ID
• Package ID
• Destination address (fulfillment center code)
• Dimensions (length, width, height, unit)
• Weight and weight unit
• Items in the box with quantities
• Expiration dates (if applicable)
• Pagination token for fetching additional pages

List Plan Shipments

Use the "List Plan Shipments" operation to retrieve all shipments for a specific FBA inbound plan:

1. Add the Seller Assistant node to your workflow
2. Select "FBA Inbound" as the resource
3. Select "List Plan Shipments" as the operation
4. Enter the Inbound Plan ID (Workflow ID)
5. Select the Amazon marketplace domain
6. Execute the node to get shipments

Note: This operation requires an Amazon seller account integration. Connect your account at Seller Assistant Integrations.

The node returns shipment information including:

• Shipment ID and status
• Source and destination addresses
• Contact information
• Tracking details (LTL and SPD)
• Delivery window information
• Freight information
• Self-ship appointment details

List Shipment Boxes

Use the "List Shipment Boxes" operation to retrieve all boxes for a specific shipment:

1. Add the Seller Assistant node to your workflow
2. Select "FBA Inbound" as the resource
3. Select "List Shipment Boxes" as the operation
4. Enter the Inbound Plan ID (Workflow ID)
5. Enter the Shipment ID (sh... or FBA... format)
6. Select the Amazon marketplace domain
7. Optionally configure page size and pagination token
8. Execute the node to get shipment boxes

Note: This operation requires an Amazon seller account integration. Connect your account at Seller Assistant Integrations.

The node returns box information including:

• Package ID and Box ID
• Destination region (warehouse ID, country, state)
• Dimensions (length, width, height, unit)
• Weight and weight unit
• Items in the box with quantities and prep instructions
• Template name
• Pagination token for fetching additional pages

List Shipment Items

Use the "List Shipment Items" operation to retrieve all items in a specific shipment:

1. Add the Seller Assistant node to your workflow
2. Select "FBA Inbound" as the resource
3. Select "List Shipment Items" as the operation
4. Enter the Inbound Plan ID (Workflow ID)
5. Enter the Shipment ID (sh... or FBA... format)
6. Select the Amazon marketplace domain
7. Optionally configure page size and detailed mode
8. Execute the node to get shipment items

Note: This operation requires an Amazon seller account integration. Connect your account at Seller Assistant Integrations.

The node returns item information including:

• ASIN and FNSKU
• Merchant SKU (MSKU)
• Quantity
• Label owner (AMAZON, SELLER, NONE)
• Prep instructions with fees
• Expiration date (if applicable)
• Manufacturing lot code (if applicable)

Create or Update Listing from ASIN

Use the "Create or Update Listing from ASIN" operation to create or update a listing by copying product data from an existing ASIN:

1. Add the Seller Assistant node to your workflow
2. Select "Listings Items" as the resource
3. Select "Create or Update Listing from ASIN" as the operation
4. Enter your unique SKU for the listing
5. Enter the ASIN of the existing product (must not be a parent ASIN)
6. Enter the selling price and currency
7. Select the item condition (new, used, refurbished, collectible)
8. Select the Amazon marketplace domain
9. Optionally configure FBA settings, dangerous goods regulation, and attribute overrides
10. Execute the node to create or update the listing

Note: This operation requires an Amazon seller account integration. Connect your account at Seller Assistant Integrations.

The node returns submission information including:

• SKU of the listing
• Status (ACCEPTED, INVALID, or VALID for validation preview)
• Submission ID
• Any issues with severity levels (ERROR, WARNING, INFO)

You can use the "Validation Mode" option to preview and check for errors before actual submission.

Delete Listings Item

Use the "Delete Listings Item" operation to delete a listings item by seller SKU:

1. Add the Seller Assistant node to your workflow
2. Select "Listings Items" as the resource
3. Select "Delete Listings Item" as the operation
4. Enter the seller SKU of the item to delete
5. Select the Amazon marketplace domain
6. Execute the node to delete the listing

Note: This operation requires an Amazon seller account integration. Connect your account at Seller Assistant Integrations.

The node returns submission information including:

• SKU of the deleted listing
• Status (ACCEPTED, INVALID)
• Submission ID
• Any issues with severity levels (ERROR, WARNING, INFO)

Get Listings Item

Use the "Get Listings Item" operation to retrieve a listings item by seller SKU:

1. Add the Seller Assistant node to your workflow
2. Select "Listings Items" as the resource
3. Select "Get Listings Item" as the operation
4. Enter the seller SKU of the item
5. Select the Amazon marketplace domain
6. Optionally configure included data (summaries, attributes, issues, offers, etc.)
7. Execute the node to get item details

Note: This operation requires an Amazon seller account integration. Connect your account at Seller Assistant Integrations.

The node returns listing item information including:

• SKU and ASIN
• Product summaries (condition, status, FNSKU, item name, images)
• Attributes (structured product data)
• Issues with severity levels and enforcement actions
• Offers and pricing data
• Fulfillment availability
• Procurement information
• Relationships (variations, package hierarchy)
• Product types

Search Listings Items

Use the "Search Listings Items" operation to search for listings items by identifiers:

1. Add the Seller Assistant node to your workflow
2. Select "Listings Items" as the resource
3. Select "Search Listings Items" as the operation
4. Enter comma-delimited identifiers (max 20)
5. Select the identifier type (SKU, ASIN, EAN, UPC, etc.)
6. Select the Amazon marketplace domain
7. Optionally configure filtering options (included data, dates, status filters, sorting, pagination)
8. Execute the node to search listings

Note: This operation requires an Amazon seller account integration. Connect your account at Seller Assistant Integrations.

The node returns listing items including:

• SKU and ASIN
• Product summaries and attributes
• Fulfillment availability
• Issues with severity levels
• Offers and procurement data
• Relationships and variation info
• Pagination token for fetching additional pages

Get Keepa Product

Use the "Get Product" operation to retrieve detailed Keepa data for an Amazon product:

1. Add the Seller Assistant node to your workflow
2. Select "Keepa" as the resource
3. Select "Get Product" as the operation
4. Choose lookup method (ASIN or UPC/EAN code)
5. Enter the ASIN or UPC/EAN code
6. Select the Amazon marketplace domain
7. Configure optional parameters (stats, history, offers, etc.)
8. Execute the node to get Keepa product data

The node returns comprehensive Keepa data including:

• Product details (title, brand, manufacturer, dimensions, etc.)
• Price history for all price types (Amazon, new, used, Buy Box, etc.)
• Sales rank history
• Marketplace offers data (with offers parameter)
• Buy Box information
• Rating and review history

Keepa Product Finder

Use the "Product Finder" operation to search for products matching specified criteria:

1. Add the Seller Assistant node to your workflow
2. Select "Keepa" as the resource
3. Select "Product Finder" as the operation
4. Select the Amazon marketplace domain
5. Enter filter criteria as JSON (see examples below)
6. Configure optional parameters (page, perPage, sort, include search insights)
7. Execute the node to find matching products

The node accepts a JSON object with filter criteria. Common filter examples:

{
  "title": "board game",
  "current_SALES_gte": 1,
  "current_SALES_lte": 100000
}

{
  "brand": ["CATAN", "Hasbro"],
  "monthlySold_gte": 100,
  "current_AMAZON_gte": 1000,
  "current_AMAZON_lte": 5000
}

{
  "rootCategory": [165793011],
  "hasReviews": true,
  "current_RATING_gte": 40
}

Available filter categories:

• Text filters: title, brand, manufacturer, model, color, size, edition, format
• Price filters: current_AMAZON_gte/lte, current_NEW_gte/lte, current_BUY_BOX_SHIPPING_gte/lte
• Sales filters: current_SALES_gte/lte, monthlySold_gte/lte
• Rating filters: current_RATING_gte/lte, current_COUNT_REVIEWS_gte/lte
• Dimension filters: packageHeight_gte/lte, packageWeight_gte/lte, itemWeight_gte/lte
• Buy Box filters: buyBoxIsAmazon, buyBoxIsFBA, buyBoxStatsAmazon30_gte/lte
• Boolean filters: hasReviews, isAdultProduct, isSNS, isEligibleForTradeIn

See the Seller Assistant API documentation for the complete list of available filters.

Search Keepa Products

Use the "Search Products" operation to search for Amazon products using keywords:

1. Add the Seller Assistant node to your workflow
2. Select "Keepa" as the resource
3. Select "Search Products" as the operation
4. Enter the search term (e.g., "Catan")
5. Select the Amazon marketplace domain
6. Configure optional parameters (ASINs only, page, stats, history, etc.)
7. Execute the node to search products

The node returns up to 100 results per search term, with results ordered as on Amazon (excluding sponsored content). Each page provides up to 10 results, iterate through pages 0-9 for more results.

Options include:

• ASINs Only - Return only ASINs instead of full product objects
• Page - Page number (0-9) for pagination
• Stats - Include price statistics for last X days or a date range
• Update - Force refresh if data is older than specified hours
• Include History - Include historical data fields
• Include Rating - Include rating and review count history

Calculate Product Profit

Use the "Calculate Product Profit" operation to calculate profit metrics for an Amazon product:

1. Add the Seller Assistant node to your workflow
2. Select "Product" as the resource
3. Select "Calculate Product Profit" as the operation
4. Enter the ASIN of the product
5. Select the Amazon marketplace domain
6. Enter the Cost of Goods (COG)
7. Enter the FBA 3PL cost (Third Party Logistics for FBA)
8. Enter the FBM 3PL cost (Third Party Logistics for FBM)
9. Optionally enter an override price to use instead of the Amazon price
10. Execute the node to calculate profit

Note: This operation requires an Amazon seller account integration. Connect your account at Seller Assistant Integrations.

The node returns profit calculations including:

• FBA and FBM profit breakdowns (price, COG, referral fee, FBA/FBM fees, storage fee, profit)
• ROI and margin percentages
• Break-even price analysis
• ROI 10% and ROI 20% price targets
• Estimated monthly sales and revenue

Get Product Info

Use the "Get Product Info" operation to retrieve detailed information about an Amazon product:

1. Add the Seller Assistant node to your workflow
2. Select "Product" as the resource
3. Select "Get Product Info" as the operation
4. Enter the ASIN (Amazon Standard Identification Number) of the product
5. Execute the node to retrieve product data

The node returns comprehensive product information including title, pricing, category, and more.

Get Product Statistics

Use the "Get Product Statistics" operation to retrieve detailed statistics for an Amazon product:

1. Add the Seller Assistant node to your workflow
2. Select "Product" as the resource
3. Select "Get Product Statistics" as the operation
4. Enter the ASIN of the product
5. Select the Amazon marketplace domain
6. Execute the node to retrieve product statistics

The node returns statistics including:

• Monthly sales estimates
• Price metrics (Amazon price, marketplace new price, Buy Box price, FBM price, FBA price) with current and historical averages
• Best Sellers Rank (BSR) with current and historical averages
• Number of offers and reviews
• BSR drops count (indicator of sales spikes)

Check ASIN Restrictions

Use the "Check ASIN Restrictions" operation to check if you are allowed to sell a product:

1. Add the Seller Assistant node to your workflow
2. Select "Restriction" as the resource
3. Select "Check ASIN Restrictions" as the operation
4. Enter the ASIN of the product
5. Select the Amazon marketplace domain
6. Execute the node to check restrictions

Note: This operation requires an Amazon seller account integration. Connect your account at Seller Assistant Integrations.

The node returns one of the following statuses:

• ALLOWED_TO_SELL - You can sell this product
• NOT_ELIGIBLE - You are not eligible to sell this product
• APPROVAL_REQUIRED - You need approval to sell this product

Estimate Sales by ASIN

Use the "Estimate by ASIN" operation to estimate monthly sales for a product:

1. Add the Seller Assistant node to your workflow
2. Select "Sales" as the resource
3. Select "Estimate by ASIN" as the operation
4. Enter the ASIN of the product
5. Select the Amazon marketplace domain
6. Execute the node to get sales estimate

The node returns the estimated monthly sales number for the product.

Estimate Sales by BSR

Use the "Estimate by BSR" operation to estimate monthly sales based on BSR and category:

1. Add the Seller Assistant node to your workflow
2. Select "Sales" as the resource
3. Select "Estimate by BSR" as the operation
4. Enter the Best Seller Rank (BSR) number
5. Enter the root category name (e.g., "Home & Kitchen")
6. Select the Amazon marketplace domain
7. Execute the node to get sales estimate

The node returns the estimated monthly sales number based on the provided BSR and category.

Resources

• n8n community nodes documentation
• Seller Assistant Website
• Seller Assistant API Documentation