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"
}]
}'
const response = await fetch('https://api.liquid.tf/api/dev/listing', {
method: 'PATCH',
headers: {
'Content-Type': 'application/json',
'X-API-Key': 'YOUR_SITE_API_KEY'
},
body: JSON.stringify({
items: [{
listing_id: '66f2b3f4c4a1f7b9a8a4f123',
price: 17000,
promoted: 0,
user_note: 'Updated condition notes'
}]
})
});
const data = await response.json();
import requests
response = requests.patch(
'https://api.liquid.tf/api/dev/listing',
headers={'X-API-Key': 'YOUR_SITE_API_KEY'},
json={
'items': [{
'listing_id': '66f2b3f4c4a1f7b9a8a4f123',
'price': 17000,
'promoted': 0,
'user_note': 'Updated condition notes'
}]
}
)
data = response.json()
{
"success": true
}
Listing Management
Edit Listings
Update price, promotion status, or user notes for existing listings
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"
}]
}'
const response = await fetch('https://api.liquid.tf/api/dev/listing', {
method: 'PATCH',
headers: {
'Content-Type': 'application/json',
'X-API-Key': 'YOUR_SITE_API_KEY'
},
body: JSON.stringify({
items: [{
listing_id: '66f2b3f4c4a1f7b9a8a4f123',
price: 17000,
promoted: 0,
user_note: 'Updated condition notes'
}]
})
});
const data = await response.json();
import requests
response = requests.patch(
'https://api.liquid.tf/api/dev/listing',
headers={'X-API-Key': 'YOUR_SITE_API_KEY'},
json={
'items': [{
'listing_id': '66f2b3f4c4a1f7b9a8a4f123',
'price': 17000,
'promoted': 0,
'user_note': 'Updated condition notes'
}]
}
)
data = response.json()
{
"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
string
required
Your site API key
Rate Limit
5 requests per minuteRequest Body
array
required
Array of listings to edit (max 100 items)
Response
boolean
Returns
true if listings were successfully updatedcurl -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"
}]
}'
const response = await fetch('https://api.liquid.tf/api/dev/listing', {
method: 'PATCH',
headers: {
'Content-Type': 'application/json',
'X-API-Key': 'YOUR_SITE_API_KEY'
},
body: JSON.stringify({
items: [{
listing_id: '66f2b3f4c4a1f7b9a8a4f123',
price: 17000,
promoted: 0,
user_note: 'Updated condition notes'
}]
})
});
const data = await response.json();
import requests
response = requests.patch(
'https://api.liquid.tf/api/dev/listing',
headers={'X-API-Key': 'YOUR_SITE_API_KEY'},
json={
'items': [{
'listing_id': '66f2b3f4c4a1f7b9a8a4f123',
'price': 17000,
'promoted': 0,
'user_note': 'Updated condition notes'
}]
}
)
data = response.json()
{
"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 removePrice changes take effect immediately and update the listing’s timestamp in search results.
