---
title: "Search catalog"
method: GET
path: "/catalog/search"
tags: ["Catalog"]
---

# Search catalog

`GET /catalog/search`

Search catalog API allows you to search the StockX catalog via freeform text, GTIN (UPC, EAN, ITF-14) or styleId.
The output is a paginated list of products that match the search term provided in the API call.

## Query parameters

- `query` string, required
- `pageNumber` integer
- `pageSize` integer

## Response `200`

Ok

- Search
  - `count` number, double, required — Total number of items present
  - `pageSize` number, double, required — Total number of items in the current page
  - `pageNumber` number, double, required — Requested page number. Starts at 1.
  - `hasNextPage` boolean, required — Returns true if there are elements in the next page.
  - `products` SearchProduct[], required — List of products that matched the search term
    - `productId` string, required — Unique identifier for a product
    - `urlKey` string, required — The product name
    - `styleId` string, nullable, required — ID of product style
    - `productType` string, required — The type of product categories that are available on StockX
    - `title` string, nullable, required — A string that uniquely identifies the product name.
    - `brand` string, nullable, required — Brand of the product
    - `productAttributes` object, required — Object containing the attributes of the product.
      - `gender` string, nullable, required — Gender targeted product
      - `season` string, nullable, required — The season the product was released
      - `releaseDate` string, nullable, required — The date the product was released
      - `retailPrice` number, double, nullable, required — The retail price of the product.
      - `colorway` string, nullable, required — The combinations of colors in which the product is designed
      - `color` string, nullable, required — Color of product

## Other responses

- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.net/stockx/apis/stockx-public-api.md) · [All operations](https://skmtc.net/stockx/apis/stockx-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stockx/stockx-public-api/versions/5b4ba84182d7/schema)