Seller Assistant API
Home
Seller AssistantHelp CenterAccount
Home
Seller AssistantHelp CenterAccount
Get API Keys
  1. SP-API Product Type Definitions
  • Introduction
  • Authentication
  • Throttling
  • Error Handling
  • Swagger Documentation
  • Amazon SP-API Marketplace IDs
  • Amazon Marketplace Categories
  • User Info
    • Get current user info
      GET
  • 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
  • SA Products
    • Autocomplete products from multiple sources for internal product creation
    • Search internal products
    • Get internal product
    • Delete internal product
    • Update internal product
    • Create internal product
    • Set or unset default supplier
    • Assign or remove a tag from an internal product
    • List product supplier offers
    • Create or update product supplier offer
    • Delete product supplier offer
    • List external product identifiers
    • Create or update external product identifier(s)
    • Delete external product identifiers
  • SA Suppliers
    • List suppliers
    • Create supplier
    • Get supplier
    • Delete supplier
    • Update supplier
    • Get all supplier offers for a specific supplier
  • SA Products History
    • Get history for internal product
    • Get history for all products in team
    • Get available history action types
  • 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
    • Get a product type definition
      GET
  • Schemas
    • Schemas
      • ApiError
      • CheckAsinRestrictionsRequest
      • EstimateSalesRequest
      • AmazonSellerAccountRequiredApiError
      • InternalApiError
      • EstimateSalesByAsinRequest
      • ProductResponse
      • DangerBrand
      • ProductDefect
      • Category
      • Variation
      • Marketplace
      • Urls
      • Price
      • Size
      • ProductPriceCurrency
      • Risks
      • Offers
      • FbaDetails
    • BadRequestApiError
    • ConvertToASINResponse
    • ConvertToASINResponseItem
    • SearchKeepaProductsResponse
    • EstimateSalesResponse
    • AccessDeniedApiError
    • PaymentRequiredApiError
    • CheckAsinRestrictionsResponse
    • ConvertToASINInternalApiError
    • SearchKeepaProductsInternalApiError
    • ResourceNotFoundApiError
    • GetProductIdentifiersResponseItem
    • TooManyRequestsApiError
    • CheckRestrictionsInternalApiError
    • GetProductIdentifiersResponse
    • GetProductIdentifiersInternalApiError
    • Product
    • KeepaProductStats
    • EstimateSalesByBsrRequest
    • GetProductInternalApiError
    • ProductCategory
    • ProductBsr
    • KeepaProductCsv
    • ProductNotFoundApiError
    • ProductVariations
    • KeepaProduct
    • KeepaProductOffer
    • CurrentUserInfoResponse
    • ProductVariation
    • GetKeepaProductInternalApiError
    • GetCurrentUserInfoInternalApiError
    • ProductMarketplace
    • ProductUrls
    • Currency
    • ProductPrices
    • ProductSize
    • ProductRisks
    • ProductOffers
    • ProductFees
    • QueryKeepaProductsResponse
    • SearchInsightsObject
    • QueryKeepaProductsInternalApiError
    • PutListingsItemRequest
    • ProductStats
    • CalculateProductProfitRequest
    • PutListingsItemInternalApiError
    • GetProductStatsInternalApiError
    • ProductProfit
    • CalculateProductProfitInternalApiError
    • EstimateSalesInternalApiError
    • ListPlanShipmentsResponse
    • ListPlanShipmentsInternalApiError
    • GetShipmentFeesResponse
    • BusinessLogicApiError
    • GetShipmentFeesInternalApiError
    • InternalProduct
    • ExternalProduct
    • ExternalProductUpsertItem
    • SupplierProductOffer
    • Supplier
    • SpApiMoney
    • CreateSupplierForm
    • ShipmentAddress
    • UpdateSupplierForm
    • OldShipment
    • GetShipmentsResponse
    • GetShipmentsInternalApiError
    • OldShipmentItem
    • GetShipmentItemsResponse
    • GetShipmentItemsInternalApiError
    • SearchCatalogItemsResponse
    • GetShipmentItemsByShipmentIdResponse
    • CatalogItemsPagination
    • GetShipmentItemsByShipmentIdInternalApiError
    • Refinements
    • ListInboundPlansResponse
    • BrandRefinement
    • InboundPlanSummary
    • ClassificationRefinement
    • Address
    • CatalogItem
    • ListInboundPlansInternalApiError
    • CatalogItemBrowseClassificationsByMarketplace
    • GetInboundPlanResponse
    • CatalogItemBrowseClassification
    • GetInboundPlanInternalApiError
    • CatalogItemDimensionsByMarketplace
    • ListPlacementOptionsResponse
    • Dimensions
    • PlacementOption
    • Dimension
    • Incentive
    • CatalogItemIdentifiersByMarketplace
    • CurrencyValue
    • CatalogItemIdentifier
    • ListPlacementOptionsInternalApiError
    • CatalogItemImagesByMarketplace
    • TransportationOption
    • CatalogItemImage
    • ListTransportationOptionsResponse
    • CatalogItemProductTypeByMarketplace
    • ListTransportationOptionsInternalApiError
    • CatalogItemRelationshipsByMarketplace
    • ShipmentSummary
    • CatalogItemRelationship
    • GetShipmentInternalApiError
    • CatalogItemVariationTheme
    • ListShipmentItemsResponse
    • CatalogItemSalesRanksByMarketplace
    • ListShipmentItemsInternalApiError
    • CatalogItemClassificationSalesRank
    • CatalogItemDisplayGroupSalesRank
    • CatalogItemSummaryByMarketplace
    • CatalogItemContributor
    • CatalogItemContributorRole
    • CatalogItemVendorDetailsByMarketplace
    • CatalogItemVendorDetailsCategory
    • SearchCatalogItemsInternalApiError
    • GetCatalogItemInternalApiError
    • GetInventorySummariesResponse
    • GetInventorySummariesResult
    • InventoryPagination
    • Granularity
    • InventorySummary
    • InventoryDetails
    • ReservedQuantity
    • ResearchingQuantity
    • ResearchingQuantityEntry
    • UnfulfillableQuantity
    • GetInventorySummariesInternalApiError
    • SearchListingsItemsResponse
    • Pagination
    • CurrencyAmount
    • Points
    • Image
    • VariationTheme
    • ListingsItemSummary
    • ListingsItemIssue
    • Enforcements
    • EnforcementAction
    • ShipmentItem
    • Exemption
    • PrepInstruction
    • ListingsItemIdentifier
    • ListingOfferPrice
    • OfferAudience
    • ListInboundPlanBoxesResponse
    • FulfillmentAvailability
    • Box
    • Procurement
    • Region
    • ProductRelationship
    • BoxDimensions
    • MarketplaceRelationship
    • BoxWeight
    • ProductTypeDefinition
    • ListInboundPlanBoxesInternalApiError
    • ListingsItem
    • ListShipmentBoxesResponse
    • SearchListingsItemsInternalApiError
    • ListShipmentBoxesInternalApiError
    • GetListingsItemInternalApiError
    • ListPackingOptionsResponse
    • ListingsItemPutRequest
    • PackingOption
    • ListingsItemSubmissionResponse
    • PackingConfiguration
    • ListingsItemPatchRequest
    • BoxRequirements
    • PatchListingsItemInternalApiError
    • WeightRange
    • DeleteListingsItemInternalApiError
    • ShippingRequirements
    • ProductType
    • ShippingConfiguration
    • ProductTypeListResponse
    • ListPackingOptionsInternalApiError
    • SearchProductTypeDefinitionsInternalApiError
    • ListPackingGroupBoxesResponse
    • ProductTypeDefinitionResponse
    • ListPackingGroupBoxesInternalApiError
    • ProductTypeVersion
    • ListPackingGroupItemsResponse
    • Link
    • ListPackingGroupItemsInternalApiError
    • SchemaLink
    • PropertyGroup
    • ProductTypeDefinitionsInternalApiError
Home
Seller AssistantHelp CenterAccount
Home
Seller AssistantHelp CenterAccount
Get API Keys
  1. SP-API Product Type Definitions

Get a product type definition

GET
https://app.sellerassistant.app/api/v1/sp-api/definitions/2020-09-01/productTypes/{productType}
Proxy to https://developer-docs.amazon.com/sp-api/reference/getdefinitionsproducttype. The limit is 10 requests per minute. Amazon seller account integration is required to make this request. You can do it here.

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

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 --request GET 'https://app.sellerassistant.app/api/v1/sp-api/definitions/2020-09-01/productTypes/LUGGAGE?productTypeVersion=LATEST&requirements=LISTING&requirementsEnforced=ENFORCED&locale=en_US&domain=amazon.com&marketplaceId=ATVPDKIKX0DER&api_key=<api-key>'

Responses

🟢200OK
application/json
Successful response
Body

Example
{
    "schema": {
        "link": {
            "resource": "/definitions/2020-09-01/productTypes/LUGGAGE",
            "verb": "GET"
        },
        "checksum": "p+5e2+8/xK27tD+z3+e+Vw=="
    },
    "requirements": "LISTING",
    "requirementsEnforced": "ALL",
    "propertyGroups": [
        {
            "title": "Key Product Features",
            "description": "Important attributes to consider when listing this product type.",
            "propertyNames": [
                "bullet_point",
                "item_name"
            ]
        }
    ],
    "locale": "en_US",
    "marketplaceIds": [
        "ATVPDKIKX0DER"
    ],
    "productType": "LUGGAGE",
    "displayName": "Luggage",
    "productTypeVersion": {
        "version": "2.0",
        "latest": true,
        "releaseCandidate": false
    },
    "metaSchema": {
        "link": {
            "resource": "/definitions/2020-09-01/productTypes/LUGGAGE",
            "verb": "GET"
        },
        "checksum": "p+5e2+8/xK27tD+z3+e+Vw=="
    }
}
🔴500Payment Required
🟠402Forbidden
🟠403Unprocessable Entity
🟠422Too Many Requests
🟠429Internal Server Error
Modified at 2026-01-31 04:13:51
Previous
Search definitions product types
Next
ApiError
Built with