# StockX Search

## Overview

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

## Description

Search StockX for products by name, brand, SKU, or slug and receive a list of matching items with product IDs, slugs, images, and colorways.

## 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/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Search for 'Air Jordan Retro' products

```json
[
  {
    "id": "9acafeb5-bc4a-4d66-bc3a-4899d2e64775",
    "sku": null,
    "name": "Jordan 4 Retro",
    "slug": "air-jordan-4-retro-toro-bravo-2026",
    "brand": "Jordan",
    "image": "https://images.stockx.com/images/Air-Jordan-4-Retro-Toro-Bravo-2026-Product.jpg?fit=fill&bg=FFFFFF&w=140&h=100&fm=webp&auto=compress&q=90&dpr=2&trim=color&updated_at=1775837171",
    "category": "sneakers",
    "colorway": "Toro Bravo (2026)"
  },
  {
    "id": "019c8c79-5739-7557-8d1f-4825eb64694d",
    "sku": null,
    "name": "Jordan 4 Retro OG",
    "slug": "air-jordan-4-retro-og-nigel-sylvester-brick-after-brick",
    "brand": "Jordan",
    "image": "https://images.stockx.com/images/Air-Jordan-4-Retro-OG-Nigel-Sylvester-Sail-Cinnabar-Product.jpg?fit=fill&bg=FFFFFF&w=140&h=100&fm=webp&auto=compress&q=90&dpr=2&trim=color&updated_at=1777572762",
    "category": "sneakers",
    "colorway": "Nigel Sylvester Brick After Brick"
  },
  {
    "id": "019cfdb4-3545-7b24-8773-11f7411145fb",
    "sku": null,
    "name": "Jordan 1 Retro Low OG SP",
    "slug": "air-jordan-1-retro-low-og-sp-travis-scott-sail-tropical-pink",
    "brand": "Jordan",
    "image": "https://images.stockx.com/images/Air-Jordan-1-Retro-Low-OG-SP-Travis-Scott-Sail-Tropical-Pink-Product.jpg?fit=fill&bg=FFFFFF&w=140&h=100&fm=webp&auto=compress&q=90&dpr=2&trim=color&updated_at=1779381546",
    "category": "sneakers",
    "colorway": "Travis Scott Sail Tropical Pink"
  },
  {
    "id": "15795a80-5cc8-4d2d-9ed0-20250d83be7f",
    "sku": null,
    "name": "Jordan 4 Retro",
    "slug": "air-jordan-4-retro-black-cat-2025",
    "brand": "Jordan",
    "image": "https://images.stockx.com/images/Air-Jordan-4-Retro-Black-Cat-2025-Product.jpg?fit=fill&bg=FFFFFF&w=140&h=100&fm=webp&auto=compress&q=90&dpr=2&trim=color&updated_at=1762549807",
    "category": "sneakers",
    "colorway": "Black Cat (2025)"
  }
]
```

## Documentation

## Overview
Search StockX by keyword, brand, style code (SKU), or product slug. Returns a JSON array of matching products with IDs, slugs, images, and colorways.

## Quickstart
```
GET https://api.piloterr.com/v2/stockx/search?query=Air+Jordan+Retro
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Product name, brand, SKU, or slug |

## Response fields
| Field | Type | Description |
|---|---|---|
| `[].id` | string | StockX product UUID |
| `[].slug` | string | Product slug (use with Product endpoint) |
| `[].name` | string | Product name |
| `[].sku` | string \| null | Style code / SKU (may be null) |
| `[].brand` | string | Brand name |
| `[].category` | string | Product category (e.g. `sneakers`) |
| `[].image` | string | Product thumbnail URL |
| `[].colorway` | string | Colorway description |

## Notes
- Response is a top-level JSON array (not wrapped in a `results` key).
- `sku` may be `null` for some listings; use `slug` for the Product endpoint.
- Pass `slug` to `/v2/stockx/product` for full market data.
- Costs 2 credits per call.

## Main use cases
- Resolve product names or keywords to StockX slugs
- Build sneaker auto-complete for resale platforms
- Discover product IDs for price alert workflows
- Power inventory tools with StockX catalog data