--- title: "Search catalog items" method: GET path: "/api/v1/sp-api/catalog/2022-04-01/items" tags: ["SP-API Catalog Items"] --- # Search catalog items `GET /api/v1/sp-api/catalog/2022-04-01/items` ## Request - Base URL: `https://app.sellerassistant.app` (the document declares no server; this is the origin it was published from) - URL: `https://app.sellerassistant.app/api/v1/sp-api/catalog/2022-04-01/items` - Auth: one of: - API key in query parameter `api_key` - API key in header `X-Api-Key` Proxy to https://developer-docs.amazon.com/sp-api/reference/searchcatalogitems. The limit is 60 requests per minute. Amazon seller account integration is required to make this request. You can do it [here](https://app.sellerassistant.app/integrations/seller-central). ## Response `200` Successful response - SearchCatalogItemsResponse: The response object for searching catalog items. - `numberOfResults` integer: For searches that are based on `identifiers`, `numberOfResults` is the total number of Amazon catalog items found. For searches that are based on `keywords`, `numberOfResults` is the estimated total number of Amazon catalog items that are matched by the search query. Only results up to the page count limit are returned per request regardless of the number found. Note: The maximum number of items (ASINs) that can be returned and paged through is 1,000. - `pagination` CatalogItemsPagination: Pagination tokens for multi-page responses. - `nextToken` string, nullable: A token that can be used to retrieve the next page. - `previousToken` string, nullable: A token that can be used to retrieve the previous page. - `items` CatalogItem[]: A list of items from the Amazon catalog. - `asin` string: The unique identifier of an item in the Amazon catalog. - `attributes` object, nullable: A JSON object containing structured item attribute data that is keyed by attribute name. Catalog item attributes conform to the related Amazon product type definitions. - `classifications` CatalogItemBrowseClassificationsByMarketplace[], nullable: An array of classifications (browse nodes) that is associated with the item in the Amazon catalog, grouped by `marketplaceId`. - `marketplaceId` string: Amazon marketplace identifier. - `classifications` CatalogItemBrowseClassification[], nullable: Classifications (browse nodes) that are associated with the item in the Amazon catalog. - `displayName` string: Display name for the classification. - `classificationId` string: Identifier of the classification. - `parent` CatalogItemBrowseClassification (recursive) - `dimensions` CatalogItemDimensionsByMarketplace[], nullable: An array of dimensions that are associated with the item in the Amazon catalog, grouped by `marketplaceId`. - `marketplaceId` string: Amazon marketplace identifier. - `item` Dimensions: Dimensions of an Amazon catalog item or item in its packaging. - `height` Dimension: The value of an individual dimension for an Amazon catalog item or item package. - `unit` string, nullable: Unit of measurement for the dimension value. - `value` number, float, nullable: Numeric value of the dimension. - `length` Dimension: The value of an individual dimension for an Amazon catalog item or item package. - `unit` string, nullable: Unit of measurement for the dimension value. - `value` number, float, nullable: Numeric value of the dimension. - `weight` Dimension: The value of an individual dimension for an Amazon catalog item or item package. - `unit` string, nullable: Unit of measurement for the dimension value. - `value` number, float, nullable: Numeric value of the dimension. - `width` Dimension: The value of an individual dimension for an Amazon catalog item or item package. - `unit` string, nullable: Unit of measurement for the dimension value. - `value` number, float, nullable: Numeric value of the dimension. - `package` Dimensions: Dimensions of an Amazon catalog item or item in its packaging. - `height` Dimension: The value of an individual dimension for an Amazon catalog item or item package. - `unit` string, nullable: Unit of measurement for the dimension value. - `value` number, float, nullable: Numeric value of the dimension. - `length` Dimension: The value of an individual dimension for an Amazon catalog item or item package. - `unit` string, nullable: Unit of measurement for the dimension value. - `value` number, float, nullable: Numeric value of the dimension. - `weight` Dimension: The value of an individual dimension for an Amazon catalog item or item package. - `unit` string, nullable: Unit of measurement for the dimension value. - `value` number, float, nullable: Numeric value of the dimension. - `width` Dimension: The value of an individual dimension for an Amazon catalog item or item package. - `unit` string, nullable: Unit of measurement for the dimension value. - `value` number, float, nullable: Numeric value of the dimension. - `identifiers` CatalogItemIdentifiersByMarketplace[], nullable: Identifiers associated with the item in the Amazon catalog, such as UPC and EAN identifiers. - `marketplaceId` string: Amazon marketplace identifier. - `identifiers` CatalogItemIdentifier[]: Identifiers associated with the item in the Amazon catalog for the indicated `marketplaceId`. - `identifierType` string: Type of identifier, such as UPC, EAN, or ISBN. - `identifier` string: Identifier of the item. - `images` CatalogItemImagesByMarketplace[], nullable: The images for an item in the Amazon catalog. - `marketplaceId` string: Amazon marketplace identifier. - `images` CatalogItemImage[]: Images for an item in the Amazon catalog, grouped by `marketplaceId`. - `variant` string: Variant of the image, such as `MAIN` or `PT01`. - `link` string, url: URL for the image. - `height` integer: Height of the image in pixels. - `width` integer: Width of the image in pixels. - `productTypes` CatalogItemProductTypeByMarketplace[], nullable: Product types that are associated with the Amazon catalog item. - `marketplaceId` string, nullable: Amazon marketplace identifier. - `productType` string, nullable: Name of the product type that is associated with the Amazon catalog item. - `relationships` CatalogItemRelationshipsByMarketplace[], nullable: Relationships grouped by `marketplaceId` for an Amazon catalog item (for example, variations). - `marketplaceId` string: Amazon marketplace identifier. - `relationships` CatalogItemRelationship[]: Relationships for the item. - `type` string: Type of relationship. - `childAsins` string[], nullable: ASINs of the related items that are children of this item. - `parentAsins` string[], nullable: ASINs of the related items that are parents of this item. - `variationTheme` CatalogItemVariationTheme: Variation theme for an Amazon catalog item. - `attributes` string[], nullable: Names of the Amazon catalog item attributes that are associated with the variation theme. - `theme` string, nullable: Variation theme that indicates the combination of Amazon catalog item attributes that define the variation family. - `salesRanks` CatalogItemSalesRanksByMarketplace[], nullable: Sales ranks of an Amazon catalog item. - `marketplaceId` string: Amazon marketplace identifier. - `classificationRanks` CatalogItemClassificationSalesRank[], nullable: Sales ranks of an Amazon catalog item for a `marketplaceId`, grouped by classification. - `classificationId` string: Identifier of the classification that is associated with the sales rank. - `title` string: Name of the sales rank. - `rank` integer: Sales rank. - `link` string, url, nullable: Corresponding Amazon retail website URL for the sales category. - `displayGroupRanks` CatalogItemDisplayGroupSalesRank[], nullable: Sales ranks of an Amazon catalog item for a `marketplaceId`, grouped by website display group. - `websiteDisplayGroup` string: Name of the website display group that is associated with the sales rank - `title` string: Name of the sales rank. - `rank` integer: Sales rank. - `link` string, url, nullable: Corresponding Amazon retail website URL for the sales rank. - `summaries` CatalogItemSummaryByMarketplace[], nullable: Summaries of Amazon catalog items. - `marketplaceId` string: Amazon marketplace identifier. - `adultProduct` boolean, nullable: When `true`, the Amazon catalog item is intended for an adult audience or is sexual in nature. - `autographed` boolean, nullable: When `true`, the Amazon catalog item is autographed. - `brand` string, nullable: Name of the brand that is associated with the Amazon catalog item. - `browseClassification` CatalogItemBrowseClassification: Classification (browse node) for an Amazon catalog item. - `displayName` string: Display name for the classification. - `classificationId` string: Identifier of the classification. - `parent` CatalogItemBrowseClassification (recursive) - `color` string, nullable: The color that is associated with the Amazon catalog item. - `contributors` CatalogItemContributor[], nullable: Individual contributors to the creation of the item, such as the authors or actors. - `role` CatalogItemContributorRole: Role of a contributor. - `value` string: Role value for the Amazon catalog item, such as `author` or `actor`. - `displayName` string, nullable: Display name of the role in the requested locale, such as `Author` or `Actor`. - `value` string: Name of the contributor, such as `Jane Austen`. - `itemClassification` string, nullable: Classification type that is associated with the Amazon catalog item. - `itemName` string, nullable: The name that is associated with the Amazon catalog item. - `manufacturer` string, nullable: The name of the manufacturer that is associated with the Amazon catalog item. - `memorabilia` boolean, nullable: When true, the item is classified as memorabilia. - `modelNumber` string, nullable: The model number that is associated with the Amazon catalog item. - `packageQuantity` integer, nullable: The quantity of the Amazon catalog item within one package. - `partNumber` string, nullable: The part number that is associated with the Amazon catalog item. - `releaseDate` string, date-time, nullable: The earliest date on which the Amazon catalog item can be shipped to customers. - `size` string, nullable: The name of the size of the Amazon catalog item. - `style` string, nullable: The name of the style that is associated with the Amazon catalog item. - `tradeInEligible` boolean, nullable: When true, the Amazon catalog item is eligible for trade-in. - `websiteDisplayGroup` string, nullable: The identifier of the website display group that is associated with the Amazon catalog item. - `websiteDisplayGroupName` string, nullable: The display name of the website display group that is associated with the Amazon catalog item. - `vendorDetails` CatalogItemVendorDetailsByMarketplace[], nullable: The vendor details that are associated with an Amazon catalog item. Vendor details are only available to vendors. - `marketplaceId` string: Amazon marketplace identifier. - `brandCode` string, nullable: The brand code that is associated with an Amazon catalog item. - `manufacturerCode` string, nullable: The manufacturer code that is associated with an Amazon catalog item. - `manufacturerCodeParent` string, nullable: The parent vendor code of the manufacturer code. - `productCategory` CatalogItemVendorDetailsCategory: Vendor details category. - `displayName` string, nullable: The display name of the product category or subcategory. - `value` string, nullable: The code that identifies the product category or subcategory. - `productGroup` string, nullable: The product group that is associated with an Amazon catalog item. - `productSubcategory` CatalogItemVendorDetailsCategory: Vendor details category. - `displayName` string, nullable: The display name of the product category or subcategory. - `value` string, nullable: The code that identifies the product category or subcategory. - `replenishmentCategory` string, nullable: The replenishment category that is associated with an Amazon catalog item. - `refinements` Refinements: Optional fields that you can use to refine your search results. - `brands` BrandRefinement[]: A list of brands you can use to refine your search. - `numberOfResults` integer: The estimated number of results that would still be returned if refinement key applied. - `brandName` string: Brand name. For display and can be used as a search refinement. - `classifications` ClassificationRefinement[]: A list of classifications you can use to refine your search. - `numberOfResults` integer: The estimated number of results that would still be returned if refinement key applied. - `displayName` string: Display name for the classification. - `classificationId` string: Identifier of the classification. ## Other responses - `402`: Payment Required - subscription expired or payment method required - `403`: Access denied - insufficient permissions, invalid API key, or the API request limit is used up (`public_api_key_limit`) - `422`: Business logic error - operation cannot be completed due to business rules - `429`: Too many requests - rate limit exceeded - `500`: Internal Error --- [API](https://skmtc.dev/sellerassistant/apis/seller-assistant-public-api.md) · [All operations](https://skmtc.dev/sellerassistant/apis/seller-assistant-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sellerassistant/apis/seller-assistant-public-api/revisions/5b3ecdbcadb6?raw)