Skip to main content
POST
/
v2
/
listings
/
delete-batch
{
  "listing_ids": [
    "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "b2c3d4e5-f6a7-8901-bcde-f23456789012",
    "c3d4e5f6-a7b8-9012-cdef-345678901234"
  ]
}

{
  "success": true,
  "message": "Successfully deleted 3 listing(s)",
  "deleted_count": 3,
  "new_listing_count": 1247,
  "deletions_used": 18,
  "deletions_max": 20
}

​
Overview

The Delete Listings Batch API allows you to delete multiple listings in a single request. This is useful for bulk cleanup of old or unwanted listings. A maximum of 100 listings can be deleted per request.
To obtain an API key, register for an account and subscribe to a plan.
Each plan has a permanent deletion limit (20% of max listings) to prevent abuse. Batch deletions count towards your deletion limit. If the batch would exceed your limit, the entire request is rejected. Upgrade to Enterprise for unlimited deletions.

​
Authorization

​
Authorization
string
required
Your API key for authentication

​
Request Body

​
listing_ids
array
required
Array of listing IDs to delete (maximum 100)
{
  "listing_ids": [
    "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "b2c3d4e5-f6a7-8901-bcde-f23456789012",
    "c3d4e5f6-a7b8-9012-cdef-345678901234"
  ]
}

{
  "success": true,
  "message": "Successfully deleted 3 listing(s)",
  "deleted_count": 3,
  "new_listing_count": 1247,
  "deletions_used": 18,
  "deletions_max": 20
}

​
Response Fields

FieldTypeDescription
successbooleanWhether the operation was successful
messagestringSummary of the deletion
deleted_countnumberNumber of listings actually deleted
new_listing_countnumberUpdated total number of listings after deletion
deletions_usednumberTotal number of deletions used
deletions_maxnumberMaximum deletions allowed on your plan (-1 for unlimited)

​
Notes

  • Maximum of 100 listings can be deleted per request
  • The deleted_count may be less than the number of IDs provided if some listings don’t exist
  • Invalid listing IDs are silently ignored
  • Batch deletions are atomic: if deleting would exceed your deletion limit, the entire batch is rejected

​
Use Cases

  • Bulk cleanup: Remove multiple old listings at once
  • Reset portfolio: Clear out listings when changing focus areas
  • Quota management: Free up significant quota space quickly