[ docs ]Commerce

StockX

Measured StockX market data, one operation per call. Products are named by product URL or its slug. Every fetch adds last sale, lowest ask, highest bid, averages, sales counts and bids to the product's market history. ops: products (full detail for up to ten products — last sale, 90-day and 12-month average price and sales, 72-hour sales, volatility, bids, express-ship asks, every size with its ask/bid/last sale, retail price, release date), search (keyword search, full cards), listing (a brand or category page URL, its products in order), history (stored market series for products already held, free). `country` (ISO-2, upper) prices in that region. Ops are independent — issue several as PARALLEL tool calls. Fresh fetches cost credits; anything already held is free.

POST https://api.zomler.com/api/v1/platforms/stockx

products
search
listing
history

products

from 1 credit · fresh for 12 hours

Full detail with live market data for up to ten StockX products — last sale, 90-day and 12-month averages, sales counts, bids, and every size's ask/bid/last sale.

Request fields

Field	Type	Default	Values / limits
`subjects`required	list of string	—	1-10 items
`country`	string	`—`	ISO alpha-2

Example

curl

curl -X POST https://api.zomler.com/api/v1/platforms/stockx \
  -H "X-API-Key: zk_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "request": {
    "op": "products",
    "subjects": [
      "example"
    ]
  },
  "estimateOnly": false
}'

JavaScript

const res = await fetch("https://api.zomler.com/api/v1/platforms/stockx", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.ZOMLER_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "request": {
      "op": "products",
      "subjects": [
        "example"
      ]
    },
    "estimateOnly": false
  }),
});
const envelope = await res.json();
console.log(envelope.data, envelope.cost.creditsCharged);

Python

import os, httpx

res = httpx.post(
    "https://api.zomler.com/api/v1/platforms/stockx",
    headers={"X-API-Key": os.environ["ZOMLER_API_KEY"]},
    json={
      "request": {
        "op": "products",
        "subjects": [
          "example"
        ]
      },
      "estimateOnly": False
    },
    timeout=120,
)
envelope = res.json()
print(envelope["data"], envelope["cost"]["creditsCharged"])

search

from 20 credits for 20

Keyword search on StockX — every hit a full product card.

Request fields

Field	Type	Default	Values / limits
`query`required	string	—	≤300 chars
`country`	string	`—`	ISO alpha-2
`limit`	integer	`20`	1-100

Example

curl

curl -X POST https://api.zomler.com/api/v1/platforms/stockx \
  -H "X-API-Key: zk_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "request": {
    "op": "search",
    "query": "example"
  },
  "estimateOnly": false
}'

JavaScript

const res = await fetch("https://api.zomler.com/api/v1/platforms/stockx", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.ZOMLER_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "request": {
      "op": "search",
      "query": "example"
    },
    "estimateOnly": false
  }),
});
const envelope = await res.json();
console.log(envelope.data, envelope.cost.creditsCharged);

Python

import os, httpx

res = httpx.post(
    "https://api.zomler.com/api/v1/platforms/stockx",
    headers={"X-API-Key": os.environ["ZOMLER_API_KEY"]},
    json={
      "request": {
        "op": "search",
        "query": "example"
      },
      "estimateOnly": False
    },
    timeout=120,
)
envelope = res.json()
print(envelope["data"], envelope["cost"]["creditsCharged"])

listing

from 20 credits for 20

A brand or category page URL — its products in page order.

Request fields

Field	Type	Default	Values / limits
`subject`required	string	—	≤400 chars
`country`	string	`—`	ISO alpha-2
`limit`	integer	`20`	1-100

Example

curl

curl -X POST https://api.zomler.com/api/v1/platforms/stockx \
  -H "X-API-Key: zk_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "request": {
    "op": "listing",
    "subject": "example"
  },
  "estimateOnly": false
}'

JavaScript

const res = await fetch("https://api.zomler.com/api/v1/platforms/stockx", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.ZOMLER_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "request": {
      "op": "listing",
      "subject": "example"
    },
    "estimateOnly": false
  }),
});
const envelope = await res.json();
console.log(envelope.data, envelope.cost.creditsCharged);

Python

import os, httpx

res = httpx.post(
    "https://api.zomler.com/api/v1/platforms/stockx",
    headers={"X-API-Key": os.environ["ZOMLER_API_KEY"]},
    json={
      "request": {
        "op": "listing",
        "subject": "example"
      },
      "estimateOnly": False
    },
    timeout=120,
)
envelope = res.json()
print(envelope["data"], envelope["cost"]["creditsCharged"])

history

free · reads what is held

Stored market series of products already held — free.

Request fields

Field	Type	Default	Values / limits
`subjects`required	list of string	—	1-10 items
`metric`	enum	`last_sale`	`last_salelowest_askhighest_bidaverage_price_90_dayssales_90_dayssales_72_hoursaverage_price_12_monthssales_12_monthsbidsprice_volatility`
`days`	integer	`90`	1-730

Example

curl

curl -X POST https://api.zomler.com/api/v1/platforms/stockx \
  -H "X-API-Key: zk_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "request": {
    "op": "history",
    "subjects": [
      "example"
    ]
  },
  "estimateOnly": false
}'

JavaScript

const res = await fetch("https://api.zomler.com/api/v1/platforms/stockx", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.ZOMLER_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "request": {
      "op": "history",
      "subjects": [
        "example"
      ]
    },
    "estimateOnly": false
  }),
});
const envelope = await res.json();
console.log(envelope.data, envelope.cost.creditsCharged);

Python

import os, httpx

res = httpx.post(
    "https://api.zomler.com/api/v1/platforms/stockx",
    headers={"X-API-Key": os.environ["ZOMLER_API_KEY"]},
    json={
      "request": {
        "op": "history",
        "subjects": [
          "example"
        ]
      },
      "estimateOnly": False
    },
    timeout=120,
)
envelope = res.json()
print(envelope["data"], envelope["cost"]["creditsCharged"])