Skip to main content
PATCH
/
api
/
dev
/
listing
curl -X PATCH "https://api.liquid.tf/api/dev/listing" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_SITE_API_KEY" \
  -d '{
    "items": [{
      "listing_id": "66f2b3f4c4a1f7b9a8a4f123",
      "price": 17000,
      "promoted": 0,
      "user_note": "Updated condition notes"
    }]
  }'

{
  "success": true
}

​
Overview

Edits one or more existing listings. You can update the price, promotion status, and user notes. Max 100 listings per request.

​
Authentication

​
X-API-Key
string
required
Your site API key

​
Rate Limit

5 requests per minute

​
Request Body

​
items
array
required
Array of listings to edit (max 100 items)

​
Response

​
success
boolean
Returns true if listings were successfully updated
curl -X PATCH "https://api.liquid.tf/api/dev/listing" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_SITE_API_KEY" \
  -d '{
    "items": [{
      "listing_id": "66f2b3f4c4a1f7b9a8a4f123",
      "price": 17000,
      "promoted": 0,
      "user_note": "Updated condition notes"
    }]
  }'

{
  "success": true
}

​
Common Use Cases

Price Updates

Adjust prices based on market conditions

Promotion Toggle

Feature or un-feature listings

Note Updates

Update item descriptions or details

Remove Notes

Pass user_note: "" to remove
Price changes take effect immediately and update the listing’s timestamp in search results.