Sign in

v1

latestOpenAPI 3.0.0MIT2026-08-043290199.3 KB
Catalog

Search catalog

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.

get/catalog/search

Query parameters

querystring required

Specifies a keyword, GTIN (UPC, EAN, ITF-14) or styleId string to search for products

pageNumberinteger

Requested page number. By default, the page number starts at 1.

pageSizeinteger

The number of products to return. By default, the page size starts at 1.

Response

Ok

countnumber double required

Total number of items present

pageSizenumber double required

Total number of items in the current page

pageNumbernumber double required

Requested page number. Starts at 1.

hasNextPageboolean required

Returns true if there are elements in the next page.

Example response

{
  "count": 266,
  "pageSize": 10,
  "pageNumber": 1,
  "hasNextPage": true,
  "products": [
    {
      "productId": "bf364c53-eb77-4522-955c-6a6ce952cc6f",
      "urlKey": "purple-hand-bag-leather",
      "styleId": "BY9109",
      "productType": "handbags",
      "title": "Gucci Duchessa Boston Bag",
      "brand": "Nike",
      "productAttributes": {
        "gender": "women",
        "season": "SS21",
        "releaseDate": "2017-09-14",
        "retailPrice": 456,
        "colorway": "String/Black-Villain Red-Neptune Green",
        "color": "purple"
      }
    }
  ]
}