Search catalog

Documentation

Support

Search catalog

Search catalog API allows you to search the StockX catalog via freeform text. The output is a paginated list of products that match the search term provided in the API call.

Request

Security:

api_keyjwt

query Parameters

query required	string [ 1 .. 100 ] characters Specifies a keyword search as a String. Example: query=nike
pageNumber	integer <int32> >= 1 Requested page number. By default, the page number starts at 1. Example: pageNumber=1
pageSize	integer <int32> [ 1 .. 50 ] The number of products to return. By default, the page size starts at 1. Example: pageSize=10

Responses

200

401

Unauthorized

500

Internal Server Error

get/catalog/search

Request samples

curl
JavaScript
Node.js

curl -i -X GET \
  'https://api.stockx.com/v2/catalog/search?query=string&pageNumber=1&pageSize=1' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'x-api-key: YOUR_API_KEY_HERE'

Response samples

application/json

{"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"
}
}
]
}