☰
Shoeless Joe - Home
StockX
GOAT

🔐 Authentication Status

📊 StockX API

⏳ Checking status...

🐐 GOAT/Alias API

⏳ Checking status...

🔑 Start Authentication

📚 API Overview and Endpoints

Readable summary of the endpoints available and the main data they return.

Authentication & Tokens

GET /api/auth-status
  • Status: token validity, refresh capability
  • Query: ?check=goat, ?diagnostics=true, ?format=html
POST /api/refresh-token
  • Refreshes StockX access token using refresh token
GET /api/auto-maintain-auth
  • Auto-refreshes when needed (cron/manual)
GET /api/auth-start
  • Starts StockX OAuth flow
GET /api/auth-callback
  • OAuth callback, exchanges code for tokens
GET /api/cron-refresh-token
  • Vercel cron entrypoint for auto-maintain

StockX Catalog & Market

POST /api/search
  • Search by SKU or name
  • Returns StockX matches and metadata
GET /api/product-details
  • Params: ?productId=
  • Returns title, brand, styleId, images, attributes
GET /api/market-data
  • Params: ?productId=
  • Returns bids/asks/last sale by size
POST /api/market-data
  • Offer calculation from market data

GOAT / Alias

GET /api/alias
  • Pricing insights by catalogId and size
  • Supports region-aware pricing
POST /api/alias
  • Catalog search by name/SKU

Analysis & Batch

POST /api/advanced-analysis
  • Combined StockX + Alias pricing logic
  • Returns recommendation + raw data
POST /api/process-batch
  • Batch processing for inventory items
  • Returns per-item results and errors

Vision / OCR

POST /api/venice-scan
  • Input: imageBase64 or imageUrl
  • Returns parsed box label data

Required Env (Local/Vercel)

  • StockX: STOCKX_ACCESS_TOKEN, STOCKX_REFRESH_TOKEN, STOCKX_API_KEY
  • OAuth: STOCKX_CLIENT_ID, STOCKX_CLIENT_SECRET
  • Optional: VERCEL_TOKEN, ALERT_WEBHOOK_URL