Intelligence Schema
Every response from the Reseller Intelligence API includes a normalized intelligence object with seven fields. The schema is consistent regardless of the underlying data source.
{
"intelligence": {
"median_sold_price": 27.48,
"median_sold_price_condition": "Pre-Owned",
"velocity_badge": "Steady",
"sell_through_rate": 34.2,
"price_trend": "stable",
"condition_distribution": {
"Pre-Owned": { "median_price": 27.48, "count": 52 },
"Brand New": { "median_price": 61.97, "count": 6 }
},
"sample_size": 58,
"data_confidence_score": {
"score": 90,
"level": "high",
"notes": ["Sufficient data for reliable pricing"]
}
}
} median_sold_price — Float, USD. Median price of sold listings over the past 90 days for the preferred condition. Defaults to Pre-Owned. Falls back to blended median if fewer than 3 comps. Null if total sample is fewer than 3.
median_sold_price_condition — String. Which condition's median is returned: Pre-Owned, New, New Other, or blended.
velocity_badge — Enum. Fast Seller (≥50% STR), Steady (20-49%), Slow Mover (<20%), Insufficient Data.
sell_through_rate — Float. Raw STR percentage. Null if active listing count unavailable.
price_trend — Enum. rising, stable, falling, or null if insufficient date spread.
condition_distribution — Object. Median price and count per recognized eBay condition tier.
sample_size — Integer. Total sold comps used. Always present, minimum 0.
data_confidence_score — Object. Score 0-100, level, explanatory notes array.
POST /v2/identify-and-price — Photo to full intelligence package POST /v2/identify — Photo to identification only POST /v1/comps/lookup — Keywords to sold comp data plus intelligence POST /v1/comps/batch — Batch keyword lookup POST /v1/market/active — Active market data for a query GET /health — Service health check
Pass preferred_condition to specify which condition's median price to return. Defaults to Pre-Owned if omitted.
{
"photo": "",
"preferred_condition": "New"
}