ItemSearchResults

Items in the Amazon catalog and search-related metadata.

E-CommerceMarketplaceSelling PartnerAmazonSeller CentralCatalogOrderInventoryFulfillmentMCPAgent Skills

Properties

Name Type Description
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 n
pagination object The `nextToken` and `previousToken` values that are required to retrieve paginated results.
refinements object Search refinements for searches that are based on `keywords`.
items array A list of items from the Amazon catalog.
View JSON Schema on GitHub

JSON Schema

amazon-seller-central-item-search-results-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/amazon-seller-central/main/json-schema/amazon-seller-central-item-search-results-schema.json",
  "title": "ItemSearchResults",
  "description": "Items in the Amazon catalog and search-related metadata.",
  "x-generated": "2026-09-24",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/amazon-seller-central-catalog-api-openapi.yml#/components/schemas/ItemSearchResults",
  "properties": {
    "numberOfResults": {
      "description": "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.\n\n**Note:** The maximum number of items (ASINs) that can be returned and paged through is 1,000.",
      "type": "integer"
    },
    "pagination": {
      "description": "The `nextToken` and `previousToken` values that are required to retrieve paginated results.",
      "$ref": "#/$defs/Pagination"
    },
    "refinements": {
      "description": "Search refinements for searches that are based on `keywords`.",
      "$ref": "#/$defs/Refinements"
    },
    "items": {
      "description": "A list of items from the Amazon catalog.",
      "type": "array",
      "items": {
        "$ref": "#/$defs/Item"
      }
    }
  },
  "required": [
    "numberOfResults",
    "items"
  ],
  "type": "object",
  "$defs": {
    "BrandRefinement": {
      "description": "A brand that you can use to refine your search.",
      "properties": {
        "numberOfResults": {
          "description": "The estimated number of results that would be returned if you refine your search by the specified `brandName`.",
          "type": "integer"
        },
        "brandName": {
          "description": "The brand name that you can use to refine your search.",
          "type": "string"
        }
      },
      "required": [
        "numberOfResults",
        "brandName"
      ],
      "type": "object"
    },
    "ClassificationRefinement": {
      "description": "A classification that you can use to refine your search.",
      "properties": {
        "numberOfResults": {
          "description": "The estimated number of results that would be returned if you refine your search by the specified `classificationId`.",
          "type": "integer"
        },
        "displayName": {
          "description": "Display name for the classification.",
          "type": "string"
        },
        "classificationId": {
          "description": "The identifier of the classification that you can use to refine your search.",
          "type": "string"
        }
      },
      "required": [
        "numberOfResults",
        "displayName",
        "classificationId"
      ],
      "type": "object"
    },
    "Dimension": {
      "description": "The value of an individual dimension for an Amazon catalog item or item package.",
      "properties": {
        "unit": {
          "description": "Unit of measurement for the dimension value.",
          "type": "string"
        },
        "value": {
          "description": "Numeric value of the dimension.",
          "type": "number"
        }
      },
      "type": "object"
    },
    "Dimensions": {
      "description": "Dimensions of an Amazon catalog item or item in its packaging.",
      "properties": {
        "height": {
          "description": "Height of an item or item package.",
          "$ref": "#/$defs/Dimension"
        },
        "length": {
          "description": "Length of an item or item package.",
          "$ref": "#/$defs/Dimension"
        },
        "weight": {
          "description": "Weight of an item or item package.",
          "$ref": "#/$defs/Dimension"
        },
        "width": {
          "description": "Width of an item or item package.",
          "$ref": "#/$defs/Dimension"
        }
      },
      "type": "object"
    },
    "Item": {
      "description": "An item in the Amazon catalog.",
      "properties": {
        "asin": {
          "$ref": "#/$defs/ItemAsin"
        },
        "attributes": {
          "$ref": "#/$defs/ItemAttributes"
        },
        "classifications": {
          "$ref": "#/$defs/ItemBrowseClassifications"
        },
        "dimensions": {
          "$ref": "#/$defs/ItemDimensions"
        },
        "identifiers": {
          "$ref": "#/$defs/ItemIdentifiers"
        },
        "images": {
          "$ref": "#/$defs/ItemImages"
        },
        "productTypes": {
          "$ref": "#/$defs/ItemProductTypes"
        },
        "relationships": {
          "$ref": "#/$defs/ItemRelationships"
        },
        "salesRanks": {
          "$ref": "#/$defs/ItemSalesRanks"
        },
        "summaries": {
          "$ref": "#/$defs/ItemSummaries"
        },
        "vendorDetails": {
          "$ref": "#/$defs/ItemVendorDetails"
        }
      },
      "required": [
        "asin"
      ],
      "type": "object"
    },
    "ItemAsin": {
      "description": "The unique identifier of an item in the Amazon catalog.",
      "type": "string"
    },
    "ItemAttributes": {
      "description": "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 that you can get from the [Product Type Definitions API](https://developer-docs.amazon.com/sp-api/reference/product-type-definitions-v2020-09-01).",
      "additionalProperties": true,
      "type": "object"
    },
    "ItemBrowseClassification": {
      "description": "Classification (browse node) for an Amazon catalog item.",
      "properties": {
        "displayName": {
          "description": "Display name for the classification.",
          "type": "string"
        },
        "classificationId": {
          "description": "Identifier of the classification.",
          "type": "string"
        },
        "parent": {
          "description": "Parent classification of the current classification.",
          "$ref": "#/$defs/ItemBrowseClassification"
        }
      },
      "required": [
        "displayName",
        "classificationId"
      ],
      "type": "object"
    },
    "ItemBrowseClassifications": {
      "description": "An array of classifications (browse nodes) that is associated with the item in the Amazon catalog, grouped by `marketplaceId`.",
      "items": {
        "$ref": "#/$defs/ItemBrowseClassificationsByMarketplace"
      },
      "type": "array"
    },
    "ItemBrowseClassificationsByMarketplace": {
      "description": "Classifications (browse nodes) that are associated with the item in the Amazon catalog for the indicated `marketplaceId`.",
      "properties": {
        "marketplaceId": {
          "description": "Amazon marketplace identifier. To find the ID for your marketplace, refer to [Marketplace IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids).",
          "type": "string"
        },
        "classifications": {
          "description": "Classifications (browse nodes) that are associated with the item in the Amazon catalog.",
          "items": {
            "$ref": "#/$defs/ItemBrowseClassification"
          },
          "type": "array"
        }
      },
      "required": [
        "marketplaceId"
      ],
      "type": "object"
    },
    "ItemClassificationSalesRank": {
      "description": "Sales rank of an Amazon catalog item.",
      "properties": {
        "classificationId": {
          "description": "Identifier of the classification that is associated with the sales rank.",
          "type": "string"
        },
        "title": {
          "description": "Name of the sales rank.",
          "type": "string"
        },
        "link": {
          "description": "Corresponding Amazon retail website URL for the sales category.",
          "type": "string"
        },
        "rank": {
          "description": "Sales rank.",
          "type": "integer"
        }
      },
      "required": [
        "classificationId",
        "title",
        "rank"
      ],
      "type": "object"
    },
    "ItemContributor": {
      "description": "Individual contributor to the creation of an item, such as an author or actor.",
      "properties": {
        "role": {
          "$ref": "#/$defs/ItemContributorRole"
        },
        "value": {
          "description": "Name of the contributor, such as `Jane Austen`.",
          "type": "string"
        }
      },
      "required": [
        "value",
        "role"
      ],
      "type": "object"
    },
    "ItemContributorRole": {
      "description": "Role of an individual contributor in the creation of an item, such as author or actor.",
      "properties": {
        "displayName": {
          "description": "Display name of the role in the requested locale, such as `Author` or `Actor`.",
          "type": "string"
        },
        "value": {
          "description": "Role value for the Amazon catalog item, such as `author` or `actor`.",
          "type": "string"
        }
      },
      "required": [
        "value"
      ],
      "type": "object"
    },
    "ItemDimensions": {
      "description": "An array of dimensions that are associated with the item in the Amazon catalog, grouped by `marketplaceId`.",
      "items": {
        "$ref": "#/$defs/ItemDimensionsByMarketplace"
      },
      "type": "array"
    },
    "ItemDimensionsByMarketplace": {
      "description": "Dimensions that are associated with the item in the Amazon catalog for the indicated `marketplaceId`.",
      "properties": {
        "marketplaceId": {
          "description": "Amazon marketplace identifier. To find the ID for your marketplace, refer to [Marketplace IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids).",
          "type": "string"
        },
        "item": {
          "description": "Dimensions of an Amazon catalog item.",
          "$ref": "#/$defs/Dimensions"
        },
        "package": {
          "description": "Dimensions of a package that contains an Amazon catalog item.",
          "$ref": "#/$defs/Dimensions"
        }
      },
      "required": [
        "marketplaceId"
      ],
      "type": "object"
    },
    "ItemDisplayGroupSalesRank": {
      "description": "Sales rank of an Amazon catalog item, grouped by website display group.",
      "properties": {
        "websiteDisplayGroup": {
          "description": "Name of the website display group that is associated with the sales rank",
          "type": "string"
        },
        "title": {
          "description": "Name of the sales rank.",
          "type": "string"
        },
        "link": {
          "description": "Corresponding Amazon retail website URL for the sales rank.",
          "type": "string"
        },
        "rank": {
          "description": "Sales rank.",
          "type": "integer"
        }
      },
      "required": [
        "websiteDisplayGroup",
        "title",
        "rank"
      ],
      "type": "object"
    },
    "ItemIdentifier": {
      "description": "The identifier that is associated with the item in the Amazon catalog, such as a UPC or EAN identifier.",
      "properties": {
        "identifierType": {
          "description": "Type of identifier, such as UPC, EAN, or ISBN.",
          "type": "string"
        },
        "identifier": {
          "description": "Identifier of the item.",
          "type": "string"
        }
      },
      "required": [
        "identifierType",
        "identifier"
      ],
      "type": "object"
    },
    "ItemIdentifiers": {
      "description": "Identifiers associated with the item in the Amazon catalog, such as UPC and EAN identifiers.",
      "items": {
        "$ref": "#/$defs/ItemIdentifiersByMarketplace"
      },
      "type": "array"
    },
    "ItemIdentifiersByMarketplace": {
      "description": "Identifiers that are associated with the item in the Amazon catalog, grouped by `marketplaceId`.",
      "properties": {
        "marketplaceId": {
          "description": "Amazon marketplace identifier. To find the ID for your marketplace, refer to [Marketplace IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids).identifier.",
          "type": "string"
        },
        "identifiers": {
          "description": "Identifiers associated with the item in the Amazon catalog for the indicated `marketplaceId`.",
          "items": {
            "$ref": "#/$defs/ItemIdentifier"
          },
          "type": "array"
        }
      },
      "required": [
        "marketplaceId",
        "identifiers"
      ],
      "type": "object"
    },
    "ItemImage": {
      "description": "Image for an item in the Amazon catalog.",
      "properties": {
        "variant": {
          "description": "Variant of the image, such as `MAIN` or `PT01`.",
          "type": "string",
          "enum": [
            "MAIN",
            "PT01",
            "PT02",
            "PT03",
            "PT04",
            "PT05",
            "PT06",
            "PT07",
            "PT08",
            "SWCH"
          ],
          "x-docgen-enum-table-extension": [
            {
              "value": "MAIN",
              "description": "Main image for the item"
            },
            {
              "value": "PT01",
              "description": "Other image #1 for the item"
            },
            {
              "value": "PT02",
              "description": "Other image #2 for the item"
            },
            {
              "value": "PT03",
              "description": "Other image #3 for the item"
            },
            {
              "value": "PT04",
              "description": "Other image #4 for the item"
            },
            {
              "value": "PT05",
              "description": "Other image #5 for the item"
            },
            {
              "value": "PT06",
              "description": "Other image #6 for the item"
            },
            {
              "value": "PT07",
              "description": "Other image #7 for the item"
            },
            {
              "value": "PT08",
              "description": "Other image #8 for the item"
            },
            {
              "value": "SWCH",
              "description": "Swatch image for the item"
            }
          ]
        },
        "link": {
          "description": "URL for the image.",
          "type": "string"
        },
        "height": {
          "description": "Height of the image in pixels.",
          "type": "integer"
        },
        "width": {
          "description": "Width of the image in pixels.",
          "type": "integer"
        }
      },
      "required": [
        "variant",
        "link",
        "height",
        "width"
      ],
      "type": "object"
    },
    "ItemImages": {
      "description": "The images for an item in the Amazon catalog.",
      "items": {
        "$ref": "#/$defs/ItemImagesByMarketplace"
      },
      "type": "array"
    },
    "ItemImagesByMarketplace": {
      "description": "Images for an item in the Amazon catalog, grouped by `marketplaceId`.",
      "properties": {
        "marketplaceId": {
          "description": "Amazon marketplace identifier. To find the ID for your marketplace, refer to [Marketplace IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids).",
          "type": "string"
        },
        "images": {
          "description": "Images for an item in the Amazon catalog, grouped by `marketplaceId`.",
          "items": {
            "$ref": "#/$defs/ItemImage"
          },
          "type": "array"
        }
      },
      "required": [
        "marketplaceId",
        "images"
      ],
      "type": "object"
    },
    "ItemProductTypeByMarketplace": {
      "description": "Product type that is associated with the Amazon catalog item, grouped by `marketplaceId`.",
      "properties": {
        "marketplaceId": {
          "description": "Amazon marketplace identifier. To find the ID for your marketplace, refer to [Marketplace IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids).",
          "type": "string"
        },
        "productType": {
          "description": "Name of the product type that is associated with the Amazon catalog item.",
          "type": "string"
        }
      },
      "type": "object"
    },
    "ItemProductTypes": {
      "description": "Product types that are associated with the Amazon catalog item.",
      "items": {
        "$ref": "#/$defs/ItemProductTypeByMarketplace"
      },
      "type": "array"
    },
    "ItemRelationship": {
      "description": "Relationship details for an Amazon catalog item.",
      "properties": {
        "childAsins": {
          "description": "ASINs of the related items that are children of this item.",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "parentAsins": {
          "description": "ASINs of the related items that are parents of this item.",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "variationTheme": {
          "description": "For `VARIATION` relationships, the variation theme indicates the combination of Amazon catalog item attributes that define the variation family.",
          "$ref": "#/$defs/ItemVariationTheme"
        },
        "type": {
          "description": "Type of relationship.",
          "enum": [
            "VARIATION",
            "PACKAGE_HIERARCHY"
          ],
          "x-docgen-enum-table-extension": [
            {
              "value": "VARIATION",
              "description": "The Amazon catalog item in the request is a variation parent or variation child of the related items that are identified by ASIN."
            },
            {
              "value": "PACKAGE_HIERARCHY",
              "description": "The Amazon catalog item in the request is a package container or is contained by the related items that are identified by ASIN."
            }
          ],
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    },
    "ItemRelationships": {
      "description": "Relationships grouped by `marketplaceId` for an Amazon catalog item (for example, variations).",
      "items": {
        "$ref": "#/$defs/ItemRelationshipsByMarketplace"
      },
      "type": "array"
    },
    "ItemRelationshipsByMarketplace": {
      "description": "Relationship details for the Amazon catalog item for the specified Amazon `marketplaceId`.",
      "properties": {
        "marketplaceId": {
          "description": "Amazon marketplace identifier. To find the ID for your marketplace, refer to [Marketplace IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids).",
          "type": "string"
        },
        "relationships": {
          "description": "Relationships for the item.",
          "items": {
            "$ref": "#/$defs/ItemRelationship"
          },
          "type": "array"
        }
      },
      "required": [
        "marketplaceId",
        "relationships"
      ],
      "type": "object"
    },
    "ItemSalesRanks": {
      "description": "Sales ranks of an Amazon catalog item.",
      "items": {
        "$ref": "#/$defs/ItemSalesRanksByMarketplace"
      },
      "type": "array"
    },
    "ItemSalesRanksByMarketplace": {
      "description": "Sales ranks of an Amazon catalog item, grouped by `marketplaceId`.",
      "properties": {
        "marketplaceId": {
          "description": "Amazon marketplace identifier. To find the ID for your marketplace, refer to [Marketplace IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids).",
          "type": "string"
        },
        "classificationRanks": {
          "description": "Sales ranks of an Amazon catalog item for a `marketplaceId`, grouped by classification.",
          "items": {
            "$ref": "#/$defs/ItemClassificationSalesRank"
          },
          "type": "array"
        },
        "displayGroupRanks": {
          "description": "Sales ranks of an Amazon catalog item for a `marketplaceId`, grouped by website display group.",
          "items": {
            "$ref": "#/$defs/ItemDisplayGroupSalesRank"
          },
          "type": "array"
        }
      },
      "required": [
        "marketplaceId"
      ],
      "type": "object"
    },
    "ItemSummaries": {
      "description": "Summaries of Amazon catalog items.",
      "items": {
        "$ref": "#/$defs/ItemSummaryByMarketplace"
      },
      "type": "array"
    },
    "ItemSummaryByMarketplace": {
      "description": "Information about an Amazon catalog item for the indicated `marketplaceId`.",
      "properties": {
        "marketplaceId": {
          "description": "Amazon marketplace identifier. To find the ID for your marketplace, refer to [Marketplace IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids).",
          "type": "string"
        },
        "adultProduct": {
          "description": "When `true`, the Amazon catalog item is intended for an adult audience or is sexual in nature.",
          "type": "boolean"
        },
        "autographed": {
          "description": "When `true`, the Amazon catalog item is autographed.",
          "type": "boolean"
        },
        "brand": {
          "description": "Name of the brand that is associated with the Amazon catalog item.",
          "type": "string"
        },
        "browseClassification": {
          "description": "Classification (browse node) that is associated with the Amazon catalog item.",
          "$ref": "#/$defs/ItemBrowseClassification"
        },
        "color": {
          "description": "The color that is associated with the Amazon catalog item.",
          "type": "string"
        },
        "contributors": {
          "description": "Individual contributors to the creation of the item, such as the authors or actors.",
          "items": {
            "$ref": "#/$defs/ItemContributor"
          },
          "type": "array"
        },
        "itemClassification": {
          "description": "Classification type that is associated with the Amazon catalog item.",
          "enum": [
            "BASE_PRODUCT",
            "OTHER",
            "PRODUCT_BUNDLE",
            "VARIATION_PARENT"
          ],
          "x-docgen-enum-table-extension": [
            {
              "value": "BASE_PRODUCT",
              "description": "A product that can be directly purchased. Can be a standalone ASIN or a variation child item in the Amazon catalog."
            },
            {
              "value": "OTHER",
              "description": "An item in the Amazon catalog that is not `BASE_PRODUCT`, `PRODUCT_BUNDLE`, or `VARIATION_PARENT`."
            },
            {
              "value": "PRODUCT_BUNDLE",
              "description": "A parent catalog item that represents a bundle of items."
            },
            {
              "value": "VARIATION_PARENT",
              "description": "A parent catalog item that groups child items into a variation family."
            }
          ],
          "type": "string"
        },
        "itemName": {
          "description": "The name that is associated with the Amazon catalog item.",
          "type": "string"
        },
        "manufacturer": {
          "description": "The name of the manufacturer that is associated with the Amazon catalog item.",
          "type": "string"
        },
        "memorabilia": {
          "description": "When true, the item is classified as memorabilia.",
          "type": "boolean"
        },
        "modelNumber": {
          "description": "The model number that is associated with the Amazon catalog item.",
          "type": "string"
        },
        "packageQuantity": {
          "description": "The quantity of the Amazon catalog item within one package.",
          "type": "integer"
        },
        "partNumber": {
          "description": "The part number that is associated with the Amazon catalog item.",
          "type": "string"
        },
        "releaseDate": {
          "description": "The earliest date on which the Amazon catalog item can be shipped to customers.",
          "format": "date",
          "type": "string"
        },
        "size": {
          "description": "The name of the size of the Amazon catalog item.",
          "type": "string"
        },
        "style": {
          "description": "The name of the style that is associated with the Amazon catalog item.",
          "type": "string"
        },
        "tradeInEligible": {
          "description": "When true, the Amazon catalog item is eligible for trade-in.",
          "type": "boolean"
        },
        "websiteDisplayGroup": {
          "description": "The identifier of the website display group that is associated with the Amazon catalog item.",
          "type": "string"
        },
        "websiteDisplayGroupName": {
          "description": "The display name of the website display group that is associated with the Amazon catalog item.",
          "type": "string"
        }
      },
      "required": [
        "marketplaceId"
      ],
      "type": "object"
    },
    "ItemVariationTheme": {
      "description": "The variation theme is a list of Amazon catalog item attributes that define the variation family.",
      "properties": {
        "attributes": {
          "description": "Names of the Amazon catalog item attributes that are associated with the variation theme.",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "theme": {
          "description": "Variation theme that indicates the combination of Amazon catalog item attributes that define the variation family.",
          "type": "string"
        }
      },
      "type": "object"
    },
    "ItemVendorDetails": {
      "description": "The vendor details that are associated with an Amazon catalog item. Vendor details are only available to vendors.",
      "items": {
        "$ref": "#/$defs/ItemVendorDetailsByMarketplace"
      },
      "type": "array"
    },
    "ItemVendorDetailsByMarketplace": {
      "description": "The vendor details that are associated with an Amazon catalog item for the specified `marketplaceId`.",
      "properties": {
        "marketplaceId": {
          "description": "Amazon marketplace identifier. To find the ID for your marketplace, refer to [Marketplace IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids).",
          "type": "string"
        },
        "brandCode": {
          "description": "The brand code that is associated with an Amazon catalog item.",
          "type": "string"
        },
        "manufacturerCode": {
          "description": "The manufacturer code that is associated with an Amazon catalog item.",
          "type": "string"
        },
        "manufacturerCodeParent": {
          "description": "The parent vendor code of the manufacturer code.",
          "type": "string"
        },
        "productCategory": {
          "description": "The product category that is associated with an Amazon catalog item.",
          "$ref": "#/$defs/ItemVendorDetailsCategory"
        },
        "productGroup": {
          "description": "The product group that is associated with an Amazon catalog item.",
          "type": "string"
        },
        "productSubcategory": {
          "description": "The product subcategory that is associated with an Amazon catalog item.",
          "$ref": "#/$defs/ItemVendorDetailsCategory"
        },
        "replenishmentCategory": {
          "description": "The replenishment category that is associated with an Amazon catalog item.",
          "enum": [
            "ALLOCATED",
            "BASIC_REPLENISHMENT",
            "IN_SEASON",
            "LIMITED_REPLENISHMENT",
            "MANUFACTURER_OUT_OF_STOCK",
            "NEW_PRODUCT",
            "NON_REPLENISHABLE",
            "NON_STOCKUPABLE",
            "OBSOLETE",
            "PLANNED_REPLENISHMENT"
          ],
          "x-docgen-enum-table-extension": [
            {
              "value": "ALLOCATED",
              "description": "The vendor allocates the inventory to Amazon and Amazon manually purchases it."
            },
            {
              "value": "BASIC_REPLENISHMENT",
              "description": "Inventory is manually purchased."
            },
            {
              "value": "IN_SEASON",
              "description": "Seasonal item that is manually purchased."
            },
            {
              "value": "LIMITED_REPLENISHMENT",
              "description": "Amazon generates orders for this item automatically based on unfilled demand."
            },
            {
              "value": "MANUFACTURER_OUT_OF_STOCK",
              "description": "The vendor is out of stock for an extended period of time and cannot backorder."
            },
            {
              "value": "NEW_PRODUCT",
              "description": "Amazon does not yet stock this item."
            },
            {
              "value": "NON_REPLENISHABLE",
              "description": "Indicates assortment parent used for detail page display, not actual items."
            },
            {
              "value": "NON_STOCKUPABLE",
              "description": "Drop ship inventory that Amazon does not stock in its fulfillment centers."
            },
            {
              "value": "OBSOLETE",
              "description": "The item is obsolete and should not be ordered."
            },
            {
              "value": "PLANNED_REPLENISHMENT",
              "description": "Active items that should be automatically ordered."
            }
          ],
          "type": "string"
        }
      },
      "required": [
        "marketplaceId"
      ],
      "type": "object"
    },
    "ItemVendorDetailsCategory": {
      "description": "The product category or subcategory that is associated with an Amazon catalog item.",
      "properties": {
        "displayName": {
          "description": "The display name of the product category or subcategory.",
          "type": "string"
        },
        "value": {
          "description": "The code that identifies the product category or subcategory.",
          "type": "string"
        }
      },
      "type": "object"
    },
    "Pagination": {
      "description": "Pagination occurs when a request produces a response that exceeds the `pageSize`. This means that the response is divided into individual pages. To retrieve the next page or the previous page of results, you must pass the `nextToken` value or the `previousToken` value as the `pageToken` parameter in the next request. There is no `nextToken` in the pagination object on the last page.",
      "properties": {
        "nextToken": {
          "description": "A token that you can use to retrieve the next page.",
          "type": "string"
        },
        "previousToken": {
          "description": "A token that you can use to retrieve the previous page.",
          "type": "string"
        }
      },
      "type": "object"
    },
    "Refinements": {
      "description": "Optional fields that you can use to refine your search results.",
      "properties": {
        "brands": {
          "description": "A list of brands you can use to refine your search.",
          "type": "array",
          "items": {
            "$ref": "#/$defs/BrandRefinement"
          }
        },
        "classifications": {
          "description": "A list of classifications you can use to refine your search.",
          "type": "array",
          "items": {
            "$ref": "#/$defs/ClassificationRefinement"
          }
        }
      },
      "required": [
        "brands",
        "classifications"
      ],
      "type": "object"
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/amazon-seller-central-item-search-results"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.