# StockX Product

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/stockx/product` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 2 credits per call |
| **Documentation** | https://www.piloterr.com/library/stockx-product |

## Description

Retrieve detailed product information from StockX, including market prices, bid/ask data, size variants, and product metadata.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/stockx/product' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Get Nike Air Max 1 Travis Scott product

```json
{
  "id": "c318bbcc-312a-4396-9252-698c203d1dea",
  "sku": "DO9392-700",
  "name": "Nike Air Max 1 Travis Scott Cactus Jack Saturn Gold",
  "slug": "nike-air-max-1-travis-scott-wheat",
  "brand": "Nike",
  "image": "https://images.stockx.com/images/Nike-Air-Max-1-Travis-Scott-Wheat-Product.jpg?fit=fill&bg=FFFFFF&w=700&h=500&fm=webp&auto=compress&q=90&dpr=2&trim=color&updated_at=1738193358",
  "model": "Nike Air Max 1",
  "gender": "men",
  "market": {
    "bids": {
      "lowest_ask": 168,
      "highest_bid": 270,
      "number_asks": 373,
      "number_bids": 272
    },
    "sales": {
      "last_sale": 303,
      "change_value": -7,
      "sales_last_72h": 6,
      "change_percentage": -0.0231
    },
    "shipping": {
      "standard": {
        "count": 373,
        "lowest_ask": 168,
        "inventory_type": null,
        "latest_delivery_date": null,
        "expected_delivery_date": null
      },
      "express_next_day": {
        "count": 5,
        "lowest_ask": 170,
        "inventory_type": "CUSTODIAL",
        "latest_delivery_date": "2026-06-03T21:00:00.000Z",
        "expected_delivery_date": "2026-06-03T21:00:00.000Z"
      },
      "express_standard": {
        "count": 30,
        "lowest_ask": 168,
        "inventory_type": "DFS",
        "latest_delivery_date": "2026-06-09T21:00:00.000Z",
        "expected_delivery_date": "2026-06-04T21:00:00.000Z"
      },
      "express_expedited": {
        "count": 5,
        "lowest_ask": 170,
        "inventory_type": "CUSTODIAL",
        "latest_delivery_date": "2026-06-04T21:00:00.000Z",
        "expected_delivery_date": "2026-06-04T21:00:00.000Z"
      }
    }
  },
  "traits": [
    {
      "name": "Style",
      "value": "DO9392-700"
    },
    {
      "name": "Colorway",
      "value": "Saturn Gold/Tea Tree Mist/Tent"
    },
    {
      "name": "Retail Price",
      "value": "150"
    },
    {
      "name": "Release Date",
      "value": "2022-05-27"
    },
    {
      "name": "Included Accessories",
      "value": "Grey extra laces, Special paper "
    },
    {
      "name": "Featured",
      "value": "false"
    },
    {
      "name": "Product Line",
      "value": "Nike Air Max"
    }
  ],
  "category": "sneakers",
  "variants": [
    {
      "id": "c7e40ad8-030e-4444-baaf-30569c52347b",
      "gtins": [
        {
          "type": "UPC",
          "identifier": "195867114073"
        }
      ],
      "sizes": [
        {
          "size": "US M 4",
          "type": "us m"
        },
        {
          "size": "UK 3.5",
          "type": "uk"
        },
        {
          "size": "CM 23",
          "type": "cm"
        },
        {
          "size": "KR 230",
          "type": "kr"
        },
        {
          "size": "EU 36",
          "type": "eu"
        },
        {
          "size": "US W 5.5",
          "type": "us w"
        }
      ],
      "market": {
        "bids": {
          "lowest_ask": 168,
          "highest_bid": 90,
          "number_asks": 15,
          "number_bids": 8
        },
        "sales": {
          "last_sale": 168,
          "change_value": 17,
          "sales_last_72h": 0,
          "change_percentage": 0.1019
        },
        "shipping": {
          "standard": {
            "count": 15,
            "lowest_ask": 168,
            "inventory_type": null,
            "latest_delivery_date": null,
            "expected_delivery_date": null
          },
          "express_next_day": {
            "count": 1,
            "lowest_ask": 170,
            "inventory_type": "CUSTODIAL",
            "latest_delivery_date": "2026-06-03T21:00:00.000Z",
            "expected_delivery_date": "2026-06-03T21:00:00.000Z"
          },
          "express_standard": {
            "count": 2,
            "lowest_ask": 168,
            "inventory_type": "DFS",
            "latest_delivery_date": "2026-06-09T21:00:00.000Z",
            "expected_delivery_date": "2026-06-04T21:00:00.000Z"
          },
          "express_expedited": {
            "count": 1,
            "lowest_ask": 170,
            "inventory_type": "CUSTODIAL",
            "latest_delivery_date": "2026-06-04T21:00:00.000Z",
            "expected_delivery_date": "2026-06-04T21:00:00.000Z"
          }
        }
      },
      "traits": {
        "size": "4"
      }
    }
  ],
  "breadcrumbs": [
    {
      "url": "/",
      "name": "Home",
      "level": 1
    },
    {
      "url": "/sneakers",
      "name": "sneakers",
      "level": 2
    },
    {
      "url": "/nike",
      "name": "Nike",
      "level": 3
    },
    {
      "url": "/nike/air-max",
      "name": "Air Max",
      "level": 4
    },
    {
      "url": "/nike/air-max/1",
      "name": "1",
      "level": 5
    },
    {
      "url": "/nike-air-max-1-travis-scott-wheat",
      "name": "Nike Air Max 1 Travis Scott Cactus Jack Saturn Gold",
      "level": 6
    }
  ],
  "description": "In collaboration with Travis Scott's record label Cactus Jack, the Nike Air Max 1 Travis Scott Cactus Jack Saturn Gold pays homage to outdoor exploration and the Nike ACG Pocket Knife hiking shoe. It boasts a light yellow layered mesh upper with matching Durabuck overlays and reversed Swoosh logos. A drawstring Gillie lacing system nods to common features on trail runners. At the base, a yellowed sole with a cloudy Air unit adds the finishing touch.\n<br>\n<br>\nThe Nike Air Max 1 Travis Scott Cactus Jack Saturn Gold released in May of 2022 and retailed for $150.",
  "small_image": "https://images.stockx.com/images/Nike-Air-Max-1-Travis-Scott-Wheat-Product.jpg?fit=fill&bg=FFFFFF&w=300&h=214&fm=webp&auto=compress&q=90&dpr=2&trim=color&updated_at=1738193358",
  "thumb_image": "https://images.stockx.com/images/Nike-Air-Max-1-Travis-Scott-Wheat-Product.jpg?fit=fill&bg=FFFFFF&w=140&h=100&fm=webp&auto=compress&q=90&dpr=2&trim=color&updated_at=1738193358",
  "primary_category": "Air Max"
}
```

## Documentation

## Overview
Retrieve comprehensive StockX product data for any sneaker, streetwear item, watch, or collectible. Returns market prices, shipping tiers, size variants with per-size market data, traits, breadcrumbs, and product metadata.

## Quickstart
```
GET https://api.piloterr.com/v2/stockx/product?query=nike-air-max-1-travis-scott-wheat&country=US&currency=USD
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | StockX product slug |
| `country` | string | no | Country code for pricing (default: `US`) |
| `currency` | string | no | Currency code (default: `USD`) |
| `language` | string | no | Language code (default: `en-US`) |

## Response fields
| Field | Type | Description |
|---|---|---|
| `id` | string | StockX product UUID |
| `slug` | string | Product slug |
| `name` | string | Full product name |
| `sku` | string | Style code / SKU |
| `brand` | string | Brand name |
| `model` | string | Product model |
| `gender` | string | Target gender |
| `category` | string | Top-level category (e.g. `sneakers`) |
| `primary_category` | string | Sub-category (e.g. `Air Max`) |
| `image` | string | Main product image URL |
| `small_image` | string | Medium thumbnail URL |
| `thumb_image` | string | Small thumbnail URL |
| `description` | string | Product description (may contain HTML) |
| `market.bids.lowest_ask` | number | Current lowest ask |
| `market.bids.highest_bid` | number | Current highest bid |
| `market.bids.number_asks` | integer | Active ask count |
| `market.bids.number_bids` | integer | Active bid count |
| `market.sales.last_sale` | number | Most recent sale price |
| `market.sales.change_value` | number | Price change since prior sale |
| `market.sales.change_percentage` | number | Relative price change |
| `market.sales.sales_last_72h` | integer | Sales in the last 72 hours |
| `market.shipping.standard` | object | Standard shipping lowest ask |
| `market.shipping.express_next_day` | object | Next-day express shipping |
| `market.shipping.express_standard` | object | Standard express shipping |
| `market.shipping.express_expedited` | object | Expedited express shipping |
| `traits` | array | Product attributes (`name`, `value`) |
| `variants` | array | Size variants with GTINs, sizes, and per-size market data |
| `variants[].gtins` | array | Barcode identifiers (`UPC`, `EAN-13`, etc.) |
| `variants[].sizes` | array | Size labels across regions (`us m`, `eu`, `uk`, etc.) |
| `variants[].traits.size` | string | Size label for the variant |
| `breadcrumbs` | array | Category navigation path (`url`, `name`, `level`) |

## Notes
- Use product slugs from StockX URLs, not internal UUIDs.
- Each shipping tier includes `count`, `lowest_ask`, `inventory_type`, and optional delivery dates.
- Variant-level `market` mirrors the root `market` shape (bids, sales, shipping).
- Costs 2 credits per call.

## Main use cases
- Monitor sneaker and streetwear resale market prices
- Track bid/ask spreads, sales velocity, and price trends
- Build price alert systems for high-demand products
- Enrich platforms with real-time StockX market values per size