GET
/v1/demand/score
Retrieve the Demand Score and confidence level for a given SKU in a specific pilot. Includes full signal breakdown.
GET
/v1/demand/verdict
Returns the final Scale / Watch / Pass verdict for a completed pilot. Includes comparable SKU context.
POST
/v1/pilots
Submit a new SKU set for validation. Returns a pilot_id for subsequent status and result queries.
GET
/v1/pilots/{id}/status
Check the current status of an in-progress pilot: pending, collecting, analyzing, or complete.
GET
/v1/demand/signals
Full signal time-series for a SKU. KOL pick rate, shopper vote %, and benchmark position over the 14-day window.
GET
/v1/demand/neighborhood
The demand neighborhood for a SKU — comparable products, positioning cluster, and peer score range.
GET
/v1/graph/query
Query the Demand Graph directly. Filter by category, segment, price tier, or signal type. Returns structured product-demand relationships.
POST
/v1/content/segment
Submit a content URL for SAM3 product segmentation. Returns identified products, placement coordinates, and shoppable metadata.