---
title: "Search/browse StockX products"
method: GET
path: "/stockx/search"
tags: ["StockX"]
---

# Search/browse StockX products

`GET /stockx/search`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/stockx/search`
- Auth: API key in header `x-api-key`

Browses StockX's product catalog by category with optional free-text keyword search and facet filters (gender, brand, color, shoe height, activity, availability), returning product summaries with headline pricing plus the total matching count.

## Query parameters

- `category` 'sneakers' | 'shoes' | 'apparel' | 'accessories' | 'collectibles' | 'trading-cards' | 'electronics', required
- `query` string
- `gender` 'men' | 'women' | 'kids' | 'unisex'
- `brand` string
- `model` string
- `color` 'white' | 'black' | 'multi' | 'blue' | 'grey' | 'pink' | 'red' | 'brown' | 'yellow' | 'green' | 'purple' | 'orange'
- `shoe_height` 'low' | 'mid' | 'high'
- `activity` 'basketball' | 'football' | 'golf' | 'hiking' | 'running' | 'skateboarding' | 'soccer'
- `available_now` boolean
- `xpress_ship` boolean
- `below_retail` boolean
- `sort` 'featured' | 'most-active'
- `page` integer
- `limit` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- StockxSearchResponseDoc
  - `code` integer
  - `data` StockxSearchResponse
    - `category` string
    - `limit` integer
    - `page` integer
    - `products` StockxProductSummary[]
      - `brand` string
      - `gender` string
      - `highest_bid` integer
      - `id` string
      - `image_url` string
      - `last_sale` integer
      - `lowest_ask` integer
      - `model` string
      - `product_category` string
      - `release_date` string
      - `title` string
      - `url_key` string
    - `query` string
    - `sort` string
    - `total_count` integer
  - `msg` string

## Other responses

- `400`: Bad Request
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)