API Reference
Appraisal Endpoint
Use this endpoint to appraise a product from a public image URL and receive a value range, supporting reasoning, and comparable items.
POST
/api/v1/appraise-product
10 creditsAppraise Product
Appraise an item from a public image URL and return an estimated value range with comparable references.
Request Body
image_urlstringREQUIRED
Public HTTPS image URL for the product to appraise.
descriptionstringOPTIONAL
Optional text context to guide appraisal.
countrystringOPTIONAL
Two-letter country code used for market/currency normalization.
Response Example
{
"similar_items": [
{
"title": "Omega Seamaster Vintage Watch",
"url": "https://example.com/listing/123",
"vendor": "Example Market",
"image": "https://example.com/listing/123/image.jpg",
"price": "1295.00"
}
],
"appraisal": {
"price_lower": 1100,
"price_upper": 1500,
"price_currency": "USD",
"best_match": {
"title": "Omega Seamaster Vintage Watch",
"url": "https://example.com/listing/123",
"vendor": "Example Market",
"image": "https://example.com/listing/123/image.jpg",
"price": "1295.00"
},
"reasoning": [
"Comparable sold listings cluster in a similar condition range.",
"Brand, model family, and visible wear align to a mid-market valuation."
],
"defects": []
},
"error": {
"discovery_error": null,
"image_upload_errors": [],
"price_enrichment_errors": [],
"appraisal_error": null
}
}Response Fields
similar_itemsarray
Comparable listings used by the appraisal pipeline.
appraisal.price_lowernumber
Lower bound of estimated value range.
appraisal.price_uppernumber
Upper bound of estimated value range.
appraisal.price_currencystring
ISO currency code for the returned range.
errorobject
Structured error container; empty on success.
Errors
UNAUTHORIZED401
Missing or invalid API key.
OUT_OF_CREDITS402
Your credit balance is empty.
BAD_REQUEST400
Invalid request payload (for example missing image_url).
curl -X POST https://tryvalue.ai/api/v1/appraise-product \-H "Authorization: Bearer value_your_api_key" \-H "Content-Type: application/json" \-d '{"image_url": "https://images.example.com/vintage-watch.jpg","description": "Vintage Omega Seamaster in used condition with leather strap.","country": "us"}'