Seller Assistant API
Home
Seller AssistantHelp CenterAccount
Home
Seller AssistantHelp CenterAccount
Get API Keys
  1. Seller Spy (Beta)
  • Introduction
  • Authentication
  • Throttling
  • Error Handling
  • Swagger Documentation
  • Amazon SP-API Marketplace IDs
  • Amazon Marketplace Categories
  • Products
    • Get product info
      GET
    • Get product statistics
      GET
    • Calculate product profit
      POST
  • UPC-EAN-ASIN converters
    • Get product ASINs based on identifiers (UPC or EAN)
      GET
    • Get product identifiers (UPC, EAN, etc.) based on ASIN
      GET
  • Restrictions
    • Check ASIN restrictions
      GET
  • Sales Estimation
    • Estimate sales by ASIN
      GET
    • Estimate sales by BSR and category
      POST
  • Keepa
    • Get Keepa product
    • Search Keepa products
    • Keepa Product Finder
  • FBA Inbound Shipments
    • Summary
    • List inbound plans
    • Get inbound plan
    • List inbound plan boxes
    • List plan shipments
    • Get shipment
    • List shipment items
    • Get shipment fees
    • List shipment boxes
  • Listings Items
    • Search listings items
    • Get listings item
    • Create or update listing from ASIN
    • Delete listings item
  • SP-API FBA Shipments
    • Get old shipments
    • Get old shipment items
    • Get old shipment items by old shipment id
    • List inbound plans
    • Get inbound plan
    • List inbound plan boxes
    • List placement options
    • List transportation options
    • Get shipment
    • List shipment items
    • List shipment boxes
    • List packing options
    • List packing group boxes
    • List packing group items
  • SP-API FBA Inventory
    • Get inventory summaries
  • SP-API Catalog Items
    • Search catalog items
    • Get catalog item
  • SP-API Listings Items
    • Search listings items
    • Get listings item
    • Put listings item
    • Delete listings item
    • Patch listings item
  • SP-API Product Type Definitions
    • Search definitions product types
    • Get a product type definition
  • SP-API Product Pricing
    • Get competitive pricing
    • Get competitive summary for ASINs
  • Price List Analyzer
    • Start a price list analysis, from a file or from already-mapped JSON items
    • Get price list processing status
    • Get price list results (paginated)
    • Update calculations for a single price list item
    • Update expenses configuration for a price list
  • Documents (Beta)
    • List documents
    • Upload a document
    • Delete documents
    • Get a document
    • Delete a document
    • Update a document
    • Get a download link
    • Preview an invoice import
    • Import an invoice
  • Account (Beta)
    • Get account
    • Get current user
  • Notes (Beta)
    • List notes
    • Create a note
    • Delete notes
    • Delete a note
    • Update a note
  • Product History (Beta)
    • List product history
  • Inventory Products (Beta)
    • List filter values
    • List products
    • Create products
    • Archive products
    • Get a product
    • Archive a product
    • Update a product
    • Set product matches
    • Remove product matches
  • Listings (Beta)
    • List listings
    • Create listing drafts
    • Delete listings
    • Get a listing
    • Delete a listing draft
  • Purchase Orders (Beta)
    • List purchase orders
    • Create purchase orders
    • Delete purchase orders
    • Get a purchase order
    • Delete a purchase order
    • Update a purchase order
    • List order items
    • Delete order items
    • Add order items
    • Delete an order item
    • Update an order item
  • SKUs (Beta)
    • List SKUs
    • Delete SKUs
    • Get a SKU
    • Delete a SKU
    • Update a SKU
  • Supplier Offers (Beta)
    • List supplier offers
    • Create supplier offers
    • Get a supplier offer
    • Delete a supplier offer
    • Update a supplier offer
  • Suppliers (Beta)
    • List suppliers
    • Create suppliers
    • Delete suppliers
    • Get a supplier
    • Delete a supplier
    • Update a supplier
  • Warehouses (Beta)
    • List warehouses
    • Create warehouses
    • Delete warehouses
    • Get a warehouse
    • Delete a warehouse
    • Update a warehouse
    • List prep providers
  • Repricer (Beta)
    • List repricing history
    • Get history statistics
    • Get repricer overview
    • Get repricer settings
    • Reset repricer settings
    • Update repricer settings
    • List repricer products
    • Create repricer products
    • Delete repricer products
    • Update repricer products
    • Get a repricer product
    • Delete a repricer product
    • Update a repricer product
    • Reprice a product
    • List strategies
    • Create a strategy
    • Delete strategies
    • Get a strategy
    • Delete a strategy
    • Update a strategy
    • Assign a strategy
  • Tags (Beta)
    • List tags
    • Create tags
    • Delete tags
    • Delete a tag
    • Update a tag
    • Tag products
  • Seller Spy (Beta)
    • List tracked sellers
      GET
    • Track sellers
      POST
    • Untrack sellers
      DELETE
    • Get a tracked seller
      GET
    • Untrack a seller
      DELETE
    • List seller products
      GET
    • List seller changes
      GET
    • List seller brands
      GET
    • Get the overview
      GET
    • List brand opportunities
      GET
    • Get the activity
      GET
  • Schemas
    • Schemas
      • ApiError
      • CheckAsinRestrictionsRequest
      • EstimateSalesRequest
      • AmazonSellerAccountRequiredApiError
      • InternalApiError
      • EstimateSalesByAsinRequest
      • ProductResponse
      • DangerBrand
      • ProductDefect
      • Category
      • Variation
      • Marketplace
      • Urls
      • Price
      • Size
      • ProductPriceCurrency
      • Risks
      • Offers
      • FbaDetails
    • BadRequestApiError
    • ConvertToASINResponseItem
    • AccessDeniedApiError
    • PaymentRequiredApiError
    • ConvertToASINResponse
    • ResourceNotFoundApiError
    • ConvertToASINInternalApiError
    • TooManyRequestsApiError
    • GetProductIdentifiersResponseItem
    • GetProductIdentifiersResponse
    • GetProductIdentifiersInternalApiError
    • ListPlanShipmentsResponse
    • Document
    • ListPlanShipmentsInternalApiError
    • ProductNotFoundApiError
    • GetShipmentFeesResponse
    • GetShipmentFeesInternalApiError
    • KeepaProductStats
    • KeepaProductCsv
    • KeepaProductOffer
    • KeepaProduct
    • GetKeepaProductInternalApiError
    • SearchKeepaProductsResponse
    • SearchKeepaProductsInternalApiError
    • QueryKeepaProductsResponse
    • SearchInsightsObject
    • QueryKeepaProductsInternalApiError
    • PutListingsItemRequest
    • PutListingsItemInternalApiError
    • Currency
    • Quota
    • ProductBsr
    • FeatureFlag
    • ProductCategory
    • Note
    • ProductVariations
    • NoteForm
    • ProductVariation
    • PriceListAnalyzerUploadResponse
    • ProductMarketplace
    • PriceListAnalyzerJsonItem
    • ProductUrls
    • PriceListAnalyzerStatusResponse
    • ProductPrices
    • Product
    • ProductSize
    • ProductOffers
    • GetProductInternalApiError
    • BusinessLogicApiError
    • CalculateProductProfitInternalApiError
    • ProductStats
    • ProductRisks
    • GetProductStatsInternalApiError
    • CheckRestrictionsInternalApiError
    • ProductFees
    • CalculateProductProfitRequest
    • ProductProfit
    • CheckAsinRestrictionsResponse
    • InternalProduct
    • ProductMatch
    • ProductMatchItem
    • InternalProductForm
    • ListingForm
    • Listing
    • PurchaseOrder
    • PurchaseOrderForm
    • PurchaseOrderCreateForm
    • PurchaseOrderItemForm
    • CurrentUserInfoResponse
    • Sku
    • EstimateSalesInternalApiError
    • PurchaseOrderItem
    • SupplierOffer
    • EstimateSalesResponse
    • SupplierOfferFields
    • EstimateSalesByBsrRequest
    • Supplier
    • SupplierOfferCreate
    • SearchCatalogItemsResponse
    • CatalogItemsPagination
    • CreateSupplierForm
    • Refinements
    • UpdateSupplierForm
    • BrandRefinement
    • WarehouseForm
    • ClassificationRefinement
    • Warehouse
    • CatalogItem
    • WarehouseProvider
    • CatalogItemBrowseClassificationsByMarketplace
    • RepricerProductHistoryItem
    • CatalogItemBrowseClassification
    • HistorySearchResponse
    • CatalogItemDimensionsByMarketplace
    • HistoryStats
    • Dimensions
    • RepricerDefaultSettings
    • Dimension
    • RepricerInfo
    • CatalogItemIdentifiersByMarketplace
    • RepricerSettings
    • CatalogItemIdentifier
    • UpdateRepricerSettings
    • CatalogItemImagesByMarketplace
    • RepricerProduct
    • CatalogItemImage
    • RepricerProductListResponse
    • CatalogItemProductTypeByMarketplace
    • CreateRepricerProductForm
    • CatalogItemRelationshipsByMarketplace
    • UpdateRepricerProductForm
    • CatalogItemRelationship
    • RepricerStrategy
    • CatalogItemVariationTheme
    • RepricerStrategyForm
    • CatalogItemSalesRanksByMarketplace
    • Tag
    • SellerSpySeller
    • CatalogItemClassificationSalesRank
    • TagForm
    • SellerSpySellerType
    • CatalogItemDisplayGroupSalesRank
    • SellerSpySellerDetails
    • GetCurrentUserInfoInternalApiError
    • CatalogItemSummaryByMarketplace
    • SellerSpyInsights
    • CatalogItemContributor
    • ApiV1Pagination
    • SellerSpyProduct
    • CatalogItemContributorRole
    • ApiV1BatchMeta
    • ApiV1TrialLimit
    • SellerSpyBrand
    • CatalogItemVendorDetailsByMarketplace
    • ApiV1BatchError
    • SellerSpyOverview
    • CatalogItemVendorDetailsCategory
    • SellerSpyBrandSignal
    • SearchCatalogItemsInternalApiError
    • SellerSpyActivity
    • GetCatalogItemInternalApiError
    • SellerSpyTrackForm
    • GetInventorySummariesResponse
    • GetInventorySummariesResult
    • InventoryPagination
    • Granularity
    • InventorySummary
    • InventoryDetails
    • ReservedQuantity
    • ResearchingQuantity
    • ResearchingQuantityEntry
    • UnfulfillableQuantity
    • GetInventorySummariesInternalApiError
    • SpApiMoney
    • ShipmentAddress
    • OldShipment
    • GetShipmentsResponse
    • GetShipmentsInternalApiError
    • OldShipmentItem
    • GetShipmentItemsResponse
    • GetShipmentItemsInternalApiError
    • GetShipmentItemsByShipmentIdResponse
    • GetShipmentItemsByShipmentIdInternalApiError
    • ListInboundPlansResponse
    • InboundPlanSummary
    • Address
    • ListInboundPlansInternalApiError
    • GetInboundPlanResponse
    • GetInboundPlanInternalApiError
    • ListPlacementOptionsResponse
    • PlacementOption
    • Incentive
    • CurrencyValue
    • ListPlacementOptionsInternalApiError
    • TransportationOption
    • ListTransportationOptionsResponse
    • ListTransportationOptionsInternalApiError
    • ShipmentSummary
    • GetShipmentInternalApiError
    • ShipmentItem
    • PrepInstruction
    • ListShipmentItemsResponse
    • ListShipmentItemsInternalApiError
    • ListInboundPlanBoxesResponse
    • Box
    • Region
    • BoxDimensions
    • BoxWeight
    • ListInboundPlanBoxesInternalApiError
    • ListShipmentBoxesResponse
    • ListShipmentBoxesInternalApiError
    • ListPackingOptionsResponse
    • PackingOption
    • PackingConfiguration
    • BoxRequirements
    • WeightRange
    • ShippingRequirements
    • ShippingConfiguration
    • ListPackingOptionsInternalApiError
    • ListPackingGroupBoxesResponse
    • ListPackingGroupBoxesInternalApiError
    • ListPackingGroupItemsResponse
    • ListPackingGroupItemsInternalApiError
    • SearchListingsItemsResponse
    • Pagination
    • CurrencyAmount
    • Points
    • Image
    • VariationTheme
    • ListingsItemSummary
    • ListingsItemIssue
    • Enforcements
    • EnforcementAction
    • Exemption
    • ListingsItemIdentifier
    • ListingOfferPrice
    • OfferAudience
    • FulfillmentAvailability
    • Procurement
    • ProductRelationship
    • MarketplaceRelationship
    • ProductTypeDefinition
    • ListingsItem
    • SearchListingsItemsInternalApiError
    • GetListingsItemInternalApiError
    • ListingsItemPutRequest
    • ListingsItemSubmissionResponse
    • ListingsItemPatchRequest
    • PatchListingsItemInternalApiError
    • DeleteListingsItemInternalApiError
    • ProductType
    • ProductTypeListResponse
    • SearchProductTypeDefinitionsInternalApiError
    • ProductTypeDefinitionResponse
    • ProductTypeVersion
    • Link
    • SchemaLink
    • PropertyGroup
    • ProductTypeDefinitionsInternalApiError
    • CompetitivePricingError
    • CompetitivePricingProduct
    • CompetitivePricingItem
    • CompetitivePricingResponse
    • CompetitiveSummaryError
    • CompetitiveSummaryResponse
  1. Seller Spy (Beta)

Get a tracked seller

GET
https://app.sellerassistant.app/api/v1/sa/seller-spy/sellers/{id}
Gives one tracked seller with the insights of its storefront. The first read of a seller starts its AI summary, and insights.ai_summary is null until the summary is ready.

Request

Authorization
API Key
Add parameter in query
api_key
Example:
api_key: ********************
or
API Key
Add parameter in header
X-Api-Key
Example:
X-Api-Key: ********************
or
Path Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://app.sellerassistant.app/api/v1/sa/seller-spy/sellers/?api_key=%3Capi-key%3E'

Responses

🟢200
application/json
The seller and its insights
Bodyapplication/json

Example
{
    "data": {
        "id": 12,
        "seller_id": "A1B2C3D4E5F6G7",
        "marketplace_id": "ATVPDKIKX0DER",
        "name": "Acme Goods",
        "seller_url": "https://www.amazon.com/sp?marketplaceID=ATVPDKIKX0DER&seller=A1B2C3D4E5F6G7",
        "storefront_url": "https://amazon.com/s?me=A1B2C3D4E5F6G7&marketplaceID=ATVPDKIKX0DER",
        "rating": 97,
        "rating_count": 1250,
        "stars": 4.8,
        "products_count": 340,
        "products_added_30d": 12,
        "new_brands_30d": 2,
        "is_processing": false,
        "seller_type": {
            "classified": true,
            "is_amazon": false,
            "brand_sells_itself": false,
            "is_distributor": true
        },
        "tracked_since": "2026-04-22",
        "snapshot_at": "2026-10-23T07:00:32Z",
        "insights": {
            "products_count": 340,
            "enriched_products_count": 320,
            "brands_count": 45,
            "top_brands": [
                {
                    "brand": "Acme",
                    "products_count": 58
                }
            ],
            "top_categories": [
                {
                    "category": "Home & Kitchen",
                    "products_count": 120
                }
            ],
            "brand_options": [
                "Acme",
                "Globex"
            ],
            "category_options": [
                "Home & Kitchen",
                "Toys & Games"
            ],
            "overlap": {
                "you_sell": 6,
                "gap": 334,
                "your_total": 210
            },
            "brand_overlap": {
                "you_carry": 3,
                "gap": 42,
                "your_total": 37
            },
            "activity": {
                "window_days": 7,
                "products_added": 12,
                "products_removed": 5,
                "new_brands": 2
            },
            "ai_summary": "A distributor of kitchen and home goods with 45 brands.",
            "business_name": "Acme Goods LLC",
            "address": "100 Main St, Springfield, IL, 62701, US",
            "country": "US",
            "has_fba": true,
            "ships_from_china": false
        }
    }
}
🟠402PaymentRequired
🟠403AccessDenied
🟠404NotFound
🟠429TooManyRequests
Modified at 2026-10-30 12:07:01
Previous
Untrack sellers
Next
Untrack a seller
Built with