StockX
Live resale prices, market stats and sales history.
/stockx/v1/product_detail2 creditsfull 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 | Allowed / range | Description | |
|---|---|---|---|
| url_key | optional | — | Product slug from the StockX product URL (stockx.com/<url_key>) — copy it from search results. Internal id/uuid also accepted. Provide url_key OR url. |
| url | optional | — | Full StockX product URL — alternative to url_key. |
| currency = USD | optional | USD · EUR · GBP · JPY · AUD · CAD · CHF · HKD · KRW · MXN · NZD · SGD · SEK · DKK · NOK · PLN · CNY · TWD · THB | Currency for all prices. |
| market = US | optional | US · GB · DE · FR · IT · ES · NL · JP · AU · CA · KR · HK · SG · CH · MX · NZ · SE · DK · NO · PL · CN · TW · TH | Marketplace region (affects asks/bids and service levels). |
/stockx/v1/search1 creditproduct 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 | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | What to search for (product keywords). |
| page = 1 | optional | 1– | Page number (40 results per page). |
| currency = USD | optional | USD · EUR · GBP · JPY · AUD · CAD · CHF · HKD · KRW · MXN · NZD · SGD · SEK · DKK · NOK · PLN · CNY · TWD · THB | Currency for all prices. |
| market = US | optional | US · GB · DE · FR · IT · ES · NL · JP · AU · CA · KR · HK · SG · CH · MX · NZ · SE · DK · NO · PL · CN · TW · TH | Marketplace region (affects asks/bids and service levels). |
/stockx/v1/recent_sales1 creditrecent transaction feed by `url`/`url_key`/`id` → sales[]{amount,created_at} (most recent first) + product ref. Best-effort market-history. `currency`/`market` optional.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| url_key | optional | — | Product slug from the StockX product URL (stockx.com/<url_key>) — copy it from search results. Internal id/uuid also accepted. Provide url_key OR url. |
| url | optional | — | Full StockX product URL — alternative to url_key. |
| currency = USD | optional | USD · EUR · GBP · JPY · AUD · CAD · CHF · HKD · KRW · MXN · NZD · SGD · SEK · DKK · NOK · PLN · CNY · TWD · THB | Currency for all prices. |
| market = US | optional | US · GB · DE · FR · IT · ES · NL · JP · AU · CA · KR · HK · SG · CH · MX · NZ · SE · DK · NO · PL · CN · TW · TH | Marketplace region (affects asks/bids and service levels). |
/stockx/v1/suggest1 creditautocomplete query suggestions for `query` (QuerySuggestion text; falls back to search-derived titles if the suggest op drifts).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | Partial search text to complete. |
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"}'{
"ok": true,
"data": { /* the result */ },
"meta": {
"latency_ms": 240,
"record_count": 12,
"completeness_pct": 100
},
"error": null
}