> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mindcase.co/llms.txt
> Use this file to discover all available pages before exploring further.

# StockX Products API

> Full StockX product detail with live market data: every size with its ask, bid and last sale. One row per product, from a brand, search or product URL.

`POST /v1/data/stockx/products/run`

**Pricing:** $0.001 per product ($1.00 per 1,000).

## Ways to call it

* **Listing URL**: set `listing_url` (optional: `maxResults`, `country_code`)
* **Search**: set `query` (optional: `maxResults`, `country_code`)
* **Product URL**: set `urls` (optional: `country_code`)

## Request

Send the inputs under `params`. Only the keys below are accepted; any other key returns `422 invalid_params`.

**listing\_url** `string`

A StockX listing page URL: a brand page ([https://stockx.com/brands/adidas](https://stockx.com/brands/adidas)) or a search results page ([https://stockx.com/search?s=jordan%201](https://stockx.com/search?s=jordan%201)). Brand pages also carry the 12-month market statistics; search pages do not.

Format e.g. `https://stockx.com/brands/adidas`.

**query** `string`

A keyword to search StockX for, e.g. 'jordan 1 chicago'. We build the search URL for you, no need to paste one. Relevance-ranked, so it drops roughly 30-40% of a brand; use a brand page as the Listing URL for a full catalog.

**urls** `string[]`

One or more StockX product URLs, e.g. [https://stockx.com/air-jordan-1-retro-high-og-chicago-reimagined-lost-and-found](https://stockx.com/air-jordan-1-retro-high-og-chicago-reimagined-lost-and-found). One per line.

**maxResults** `integer`

Number of products to return from a brand page or a search. Use 0 for all. Ignored when you pass product URLs.

**country\_code** `string` (default: US)

Shopping region. Scopes the StockX market the asks and bids come from. Prices are quoted in USD regardless.

198 allowed values, for example `AL` (Albania), `DZ` (Algeria), `AS` (American Samoa), `AD` (Andorra), `AO` (Angola), `AI` (Anguilla), `AG` (Antigua & Barbuda), `AR` (Argentina), `AM` (Armenia), `AW` (Aruba). Fetch the full list with `GET /v1/data/stockx/products?expand=options`.

## Example

```bash cURL theme={null}
curl -X POST "https://api.mindcase.co/v1/data/stockx/products/run?wait=true" \
  -H "Authorization: Bearer $MINDCASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "listing_url": "https://stockx.com/brands/adidas",
    "maxResults": 50
  }
}'
```

```python Python theme={null}
import os, requests

r = requests.post(
    "https://api.mindcase.co/v1/data/stockx/products/run",
    params={"wait": "true"},
    headers={"Authorization": f"Bearer {os.environ['MINDCASE_API_KEY']}"},
    json={"params": {
    "listing_url": "https://stockx.com/brands/adidas",
    "maxResults": 50
}},
)
job = r.json()
rows = job.get("data", [])  # if job["status"] == "running", poll /v1/jobs/{job_id}/results
```

```javascript Node.js theme={null}
const r = await fetch("https://api.mindcase.co/v1/data/stockx/products/run?wait=true", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MINDCASE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ params: {
  "listing_url": "https://stockx.com/brands/adidas",
  "maxResults": 50
} }),
});
const job = await r.json();
const rows = job.data ?? []; // if job.status === "running", poll /v1/jobs/{job_id}/results
```

## Response fields

Each row in `data` is one product, keyed by these fields.

| Field | Name | Type |
| - | - | - |
| `productId` | Product ID | text |
| `productUrl` | Product URL | url |
| `primaryTitle` | Primary Title | text |
| `secondaryTitle` | Secondary Title | text |
| `brand` | Brand | text |
| `model` | Model | text |
| `colorway` | Colorway | text |
| `styleId` | Style ID | text |
| `category` | Category | text |
| `subCategory` | Sub Category | text |
| `categoryPath` | Category Path | text |
| `contentGroup` | Content Group | text |
| `gender` | Gender | text |
| `condition` | Condition | text |
| `sizeConvention` | Size Convention | text |
| `retailPrice` | Retail Price | number |
| `releaseDate` | Release Date | date |
| `description` | Description | text |
| `tags` | Tags | array |
| `lastSale` | Last Sale | number |
| `sales72Hours` | Sales (72 Hours) | number |
| `averagePrice90Days` | Average Price (90 Days) | number |
| `sales90Days` | Sales (90 Days) | number |
| `priceVolatility` | Price Volatility | number |
| `sales12Months` | Sales (12 Months) | number |
| `averagePrice12Months` | Average Price (12 Months) | number |
| `bids` | Bids | number |
| `askInventoryType` | Ask Inventory Type | text |
| `expressAskCount` | Express Ask Count | number |
| `expressShipLowestAsk` | Express Ship Lowest Ask | number |
| `expressDeliveryDate` | Express Delivery Date | text |
| `expressLatestDeliveryDate` | Express Latest Delivery Date | text |
| `images` | Images | array |
| `sizes` | Sizes | object\_array |
| `attributes` | Attributes | object\_array |

## Example response

Abridged: long text and lists are shortened.

```json theme={null}
{
  "job_id": "7f3a1c2e-0b9d-4c55-9a51-3f2e8d1b6a40",
  "agent": "stockx/products",
  "status": "completed",
  "row_count": 1,
  "truncated": false,
  "data": [
    {
      "secondaryTitle": "White",
      "releaseDate": "2007-01-01",
      "productId": "b80ff5b5-98ab-40ff-a58c-83f6962fe8aa",
      "images": [
        "https://images.stockx.com/images/Nike-Air-Force-1-Low-White-07_V2-Product.jpg",
        "https://images.stockx.com/360/Nike-Air-Force-1-Low-White-07/Images/Nike-Air-Force-1-Low-White-07/Lv2/img01.jpg"
      ],
      "sales90Days": 8712,
      "attributes": [
        {
          "attribute": "Style",
          "value": "315122-111/CW2288-111"
        },
        {
          "attribute": "Colorway",
          "value": "White/White"
        }
      ],
      "colorway": "White/White",
      "condition": "New & Verified",
      "sizeConvention": "US M",
      "sales72Hours": 312,
      "averagePrice90Days": 81,
      "averagePrice12Months": 84,
      "expressLatestDeliveryDate": "2026-07-28T09:00:00.000Z",
      "brand": "Nike",
      "askInventoryType": "STANDARD",
      "primaryTitle": "Nike Air Force 1 Low '07",
      "lastSale": 102,
      "sizes": [
        {
          "variantId": "67db3eb8-56fe-4c70-89da-0722e85d2ac2",
          "size": "3.5",
          "sizeConversions": {
            "us m": "3.5",
            "uk": "3",
            "cm": "22.5",
            "kr": "225",
            "eu": "35.5",
            "us w": "5"
          },
          "lowestAsk": null,
          "highestBid": null,
          "lastSale": 216,
          "lastSaleChange": 143,
          "lastSaleChangePercent": 0.6615,
          "salesLast72Hours": 0,
          "averagePrice90Days": null,
          "salesCount90Days": 0,
          "numberOfAsks": 0,
          "numberOfBids": 0,
          "expressAsk": null,
          "expressAskCount": 0,
          "expressInventoryType": null,
          "expressDelivery": null,
          "expressLatestDelivery": null,
          "expeditedAsk": null,
          "expeditedAskCount": 0,
          "expeditedInventoryType": null,
          "expeditedDelivery": null,
          "expeditedLatestDelivery": null,
          "nextDayAsk": null,
          "nextDayAskCount": 0
        },
        {
          "variantId": "a09ff70f-48ca-4abd-a23a-a0fd716a4dff",
          "size": "4",
          "sizeConversions": {
            "us m": "4",
            "uk": "3.5",
            "cm": "23",
            "kr": "230",
            "eu": "36",
            "us w": "5.5"
          },
          "lowestAsk": 533,
          "highestBid": null,
          "lastSale": 70,
          "lastSaleChange": -20,
          "lastSaleChangePercent": -0.2857,
          "salesLast72Hours": 0,
          "averagePrice90Days": null,
          "salesCount90Days": 0,
          "numberOfAsks": 7,
          "numberOfBids": 0,
          "expressAsk": null,
          "expressAskCount": 0,
          "expressInventoryType": null,
          "expressDelivery": null,
          "expressLatestDelivery": null,
          "expeditedAsk": null,
          "expeditedAskCount": 0,
          "expeditedInventoryType": null,
          "expeditedDelivery": null,
          "expeditedLatestDelivery": null,
          "nextDayAsk": null,
          "nextDayAskCount": 0
        }
      ],
      "gender": "men",
      "model": "Nike Air Force 1 Low '07",
      "expressAskCount": 9,
      "retailPrice": 115,
      "description": "The Nike Air Force 1 Low White ‘07 features an all-white leather upper with a perforated toe box and Swoosh overlays. A Nike heel embroidery and white sole c...",
      "contentGroup": "sneakers",
      "category": "sneakers"
    }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.