BarcodesDocs

GET Product Alternatives

Use a style code or StockX slug to look up the associated StockX and GOAT slugs and SKUs. A stored product with neither marketplace slug returns an empty alternatives array; an unknown product returns a not-found message.

Route

/api/v2/product/alternatives/{style_code}

Ability

  • lookup-product-alternatives

Response 200 (stockx and goat found)

{
  "error": false,
  "stockx": {
    "slug": "string",
    "sku": "string"
  },
  "goat": {
    "slug": "string",
    "sku": "string"
  },
  "response_time": "XXXms",
  "request_fulfilled": true,
  "request_debited": true
}

Response 200 (fallback alternatives)

{
  "error": false,
  "alternatives": [],
  "response_time": "XXXms",
  "request_fulfilled": true,
  "request_debited": true
}

Response 200 (not found variants)

{
  "error": true,
  "message": "No product could be found for this search query. | No corresponding GOAT product could be found.",
  "response_time": "XXXms",
  "request_fulfilled": true,
  "request_debited": false
}

Response 403

{
  "error": true,
  "message": "API Token has run out of usage, please top up via the dashboard.",
  "response_time": "XXXms",
  "request_fulfilled": false,
  "request_debited": false
}