docs / stockx

StockX

Live resale prices, market stats and sales history.

base /stockx/v14 endpoints

post/stockx/v1/product_detail2 credits

full product by `url` OR `url_key`/`id`/`uuid`: title/brand/model/sku/category/colorway/retail_price/release_date/image + market{lowest_ask,highest_bid,number_of_asks/bids,last_sale,sales_last_72h,last_sale_change_pct/value,avg_price_72h/90d/annual,sales_count_*,price_premium=(last_sale-retail)/retail, volatility=CV-of-recent-sales, ask_service_levels{standard/express_*: count,lowest_ask,processing_fee,delivery}} + per-size variants[]{size,lowest_ask,highest_bid,last_sale}. The market-data moat. `currency` (USD/EUR/GBP/…) + `market` (US/GB/DE/…) optional.

Parameter	Required
url	optional
url_key	optional
id	optional
uuid	optional
currency	optional
market	optional

Try in playground →

post/stockx/v1/search1 credit

product search → results[]{id,url_key,url,title,brand,sku,category,image,lowest_ask,highest_bid,last_sale} + page_info{page,limit,total}. Resolves url_keys for product_detail. `page` (BrowsePageInput index, 40/page) + `currency`/`market` optional.

Parameter	Required
query	required
page	optional
currency	optional
market	optional

Try in playground →

post/stockx/v1/recent_sales1 credit

recent transaction feed by `url`/`url_key`/`id` → sales[]{amount,created_at} (most recent first) + product ref. Best-effort market-history. `currency`/`market` optional.

Parameter	Required
url	optional
url_key	optional
id	optional
uuid	optional
currency	optional
market	optional

Try in playground →

post/stockx/v1/suggest1 credit

autocomplete query suggestions for `query` (QuerySuggestion text; falls back to search-derived titles if the suggest op drifts).

Parameter	Required
query	required

Try in playground →

Example request · product_detail

curl -X POST https://api.reefapi.com/stockx/v1/product_detail \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"url_key":"air-jordan-4-retro-bred-reimagined"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}