Delete a listing

Learn how to delete an Amazon listing for a given selling partner and Amazon marketplace using the Listings Items API.

The following diagram provides an overview of the workflow steps to delete a listing item.

Prerequisites

To complete this tutorial, you need:

• Authorization from the selling partner for whom you are making calls. Refer to Authorizing Selling Partner API Applications for more information.
• Approval for the Product Listing role in your developer profile.
• The Product Listing role selected in the App registration page for your application.

Submit listings item delete request

Call the deleteListingsItem operation to delete a listing.

Submitting images and other media attributes

The Listings Items API accepts product images and other media content attributes from the following sources:

• Publicly accessible Amazon S3 bucket content downloaded through HTTP or HTTPS URL
• Publicly accessible Amazon CloudFront distribution content downloaded through HTTP or HTTPS URL
• Private Amazon S3 bucket content downloaded through S3 URL (for example, s3://bucket-name/object-name.jpg)
• Images hosted on third-party servers that are publicly available to Amazon.

⭐

Tip

For optimal processing performance, host your media on AWS (such as Amazon S3 or Amazon CloudFront) or other highly available content delivery network (CDN) services.
If you use a private Amazon S3 bucket, you must also configure your Amazon S3 bucket policy to allow the IAM role (arn:aws:iam:111122223333:role/Media-Download-Role) to call the GetObject and ListBucket operations on the bucket. Refer to the following S3 bucket policy for an example.

Private Amazon S3 content is treated as immutable, meaning you cannot change the content for an Amazon S3 object key. New media content requires a new Amazon S3 object key. This convention provides the benefit of improved processing times and avoids the cost of redundant downloads in case listing submissions are re-processed.

The following is an example Amazon S3 bucket policy enabling the required operations on a bucket named bucket-name:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "",
      "Action": [
        "s3:GetObject",
        "s3:ListBucket"
      ],
      "Effect": "Allow",
      "Resource": [
        "arn:aws:s3:::bucket-name/*",
        "arn:aws:s3:::bucket-name"
      ],
      "Principal": {
        "AWS": [
          "arn:aws:iam::368641386589:role/Media-Download-Role"
        ]
      }
    }
  ]
}