Seller Assistant API
Home
Seller AssistantHelp CenterAccount
Home
Seller AssistantHelp CenterAccount
Get API Keys
  1. IP-Alert (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
      GET
    • Search Keepa products
      GET
    • Keepa Product Finder
      POST
  • FBA Inbound Shipments
    • Summary
    • List inbound plans
      GET
    • Get inbound plan
      GET
    • List inbound plan boxes
      GET
    • List plan shipments
      GET
    • Get shipment
      GET
    • List shipment items
      GET
    • Get shipment fees
      GET
    • List shipment boxes
      GET
  • 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
    • Track sellers
    • Untrack sellers
    • Get a tracked seller
    • Untrack a seller
    • List seller products
    • List seller changes
    • List seller brands
    • Get the overview
    • List brand opportunities
    • Get the activity
  • IP-Alert (Beta)
    • Get IP-Alert warnings of a product
      GET
    • Get IP-Alert warnings of a brand
      GET
    • List seller IP-Alerts
      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
    • IpAlertSellerProduct
    • KeepaProductOffer
    • IpAlertWarning
    • KeepaProduct
    • IpAlertReport
    • 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. IP-Alert (Beta)

List seller IP-Alerts

GET
https://app.sellerassistant.app/api/v1/ip-alerts/sellers/{seller_id}
Gives the products of the latest storefront of the seller that are high-risk for IP-Alert, with the newest warning first. Use it to check the risk of a seller or a supplier before you buy from it. The IP-Alert data has no seller: it shows the warnings of the ASINs and brands that the seller sells, not the warnings of the seller account. The team must track the seller in Seller Spy in the marketplace of the call: add it with POST /api/v1/sa/seller-spy/sellers. A seller that Seller Assistant still reads gives an empty list. meta.summary gives the counts of the whole storefront. The call counts as one request of the API request limit.

Request

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

Query 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/ip-alerts/sellers/?marketplace_id=&page=&per_page=' \
--header 'X-Api-Key: <api-key>'

Responses

🟢200
application/json
One page of the high-risk products
Bodyapplication/json

Example
{
    "data": [
        {
            "asin": "B08N5WRWNW",
            "title": "Acme Glass Cups with Lids, 4 Pack, 20 oz",
            "brand": "Acme",
            "asin_warnings": 2,
            "brand_warnings": 14,
            "brand_owner_request": false,
            "warning_types": [
                "Suspected Intellectual Property Violation"
            ],
            "amazon_categories": [
                "Automated Brand Protection"
            ],
            "latest_warning_date": "2026-01-20"
        }
    ],
    "meta": {
        "pagination": {
            "page": 1,
            "per_page": 25,
            "total": 137,
            "last_page": 6
        },
        "trial_limit": {
            "max_rows": 25,
            "total": 137,
            "code": "trial_list_limited",
            "message": "The trial shows only the first rows of a list. Subscribe to see all rows.",
            "subscribe_url": "https://app.sellerassistant.app/subscription"
        },
        "summary": {
            "products": 340,
            "high_risk_products": 47,
            "high_risk_brands": 5
        }
    }
}
🟠400BadRequest
🟠402PaymentRequired
🟠403AccessDenied
🟠404NotFound
🟠429TooManyRequests
🔴503ServiceUnavailable
Modified at 2026-11-13 14:29:45
Previous
Get IP-Alert warnings of a brand
Next
ApiError
Built with