Nike Search API returns up to 24 product groups per page for a keyword or a category. Each group lists its colorways with style code, color, price, original price, sale price, discount, badge, images and link. Sort with sort and page with page. The total counts product groups, not colorways.
Filter with gender, size, color, price_min, price_max and sale_only. Every returned colorway is checked against the sale and price filters. Colorways that break a filter are removed and counted in removed_by_filter, so a page can hold fewer items. A page past the last page is an empty page. A successful request costs 1 credit.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
This endpoint has no required query parameters.
11 optional filters available.
string
Optional
Search keyword. Send query or category.
coffee shops
string
Optional
shoes, clothing, tops, shorts, hoodies, jackets, pants, fleece, tracksuits, underwear, swimwear or socks. Send query or category.
example
string
Optional
men, women, unisex, boys or girls.
example
string
Optional
Size label of the country site, for example 10 or M 10 / W 11.5 for shoes and M for clothing.
example
string
Optional
black, blue, brown, green, grey, multi-color, orange, pink, purple, red, white or yellow.
example
number
Optional
Lowest current price in the currency of the country.
10
number
Optional
Highest current price in the currency of the country.
10
boolean
Optional
true returns only colorways with a sale price.
true
string
Optional
relevance (default), newest, price_asc or price_desc. Price sorts order the returned page by current price.
relevance
integer
Optional
One-based page number, 1 to 100 (default 1). A page has up to 24 product groups.
1
string
Optional
Country: us (default), de, fr, gb or jp.
US
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"page": 1,
"sort": "relevance",
"items": [
{
"url": "https://www.nike.com/t/air-max-moto-2k-mens-shoes-sHpe9Gv4/IO9279-001",
"badge": null,
"price": {
"amount": 76.97,
"currency": "USD",
"discounted": true,
"sale_amount": 76.97,
"original_amount": 135,
"discount_percent": 43
},
"title": "Nike Air Max Moto 2K",
"is_new": false,
"subtitle": "Men's Shoes",
"colorways": [
{
"url": "https://www.nike.com/t/air-max-moto-2k-mens-shoes-sHpe9Gv4/IO9279-001",
"badge": null,
"color": {
"hex": "#27292B",
"label": "Black",
"description": "Black/Metallic Dark Grey/Dark Smoke Grey"
},
"price": {
"amount": 94.97,
"currency": "USD",
"discounted": true,
"sale_amount": 94.97,
"original_amount": 135,
"discount_percent": 30
},
"images": [
"https://static.nike.com/a/images/t_PDP_1280_v1/u_9ddf04c7-2a9a-4d76-add1-d15af8f0263d,c_scale,fl_relative,w_1.0,h_1.0,fl_layer_apply/78e6dfb4-e645-4206-a85d-2c8cb23bf955/NIKE+AIR+MAX+MOTO+2K.png",
"https://static.nike.com/a/images/t_PDP_1280_v1/u_9ddf04c7-2a9a-4d76-add1-d15af8f0263d,c_scale,fl_relative,w_1.0,h_1.0,fl_layer_apply/74728274-c71e-4c4d-b954-8bc9c067e43b/NIKE+AIR+MAX+MOTO+2K.png"
],
"is_new": false,
"style_code": "IO9279-001"
},
{
"url": "https://www.nike.com/t/air-max-moto-2k-mens-shoes-sHpe9Gv4/IQ4924-301",
"badge": null,
"color": {
"hex": "#007A44",
"label": "Green",
"description": "Camo Green/Spruce Fog/Sequoia/Sea Glass"
},
"price": {
"amount": 108.97,
"currency": "USD",
"discounted": true,
"sale_amount": 108.97,
"original_amount": 135,
"discount_percent": 19
},
"images": [
"https://static.nike.com/a/images/t_PDP_1280_v1/u_9ddf04c7-2a9a-4d76-add1-d15af8f0263d,c_scale,fl_relative,w_1.0,h_1.0,fl_layer_apply/13e6f6e8-4063-4894-962c-be5d50bb0e8c/NIKE+AIR+MAX+MOTO+2K.png",
"https://static.nike.com/a/images/t_PDP_1280_v1/u_9ddf04c7-2a9a-4d76-add1-d15af8f0263d,c_scale,fl_relative,w_1.0,h_1.0,fl_layer_apply/3eedfa1e-fa66-4a09-b35b-d2ed96f2a38b/NIKE+AIR+MAX+MOTO+2K.png"
],
"is_new": false,
"style_code": "IQ4924-301"
}
],
"group_key": "sHpe9Gv4",
"image_url": "https://static.nike.com/a/images/t_PDP_1280_v1/u_9ddf04c7-2a9a-4d76-add1-d15af8f0263d,c_scale,fl_relative,w_1.0,h_1.0,fl_layer_apply/78e6dfb4-e645-4206-a85d-2c8cb23bf955/NIKE+AIR+MAX+MOTO+2K.png",
"style_code": "IO9279-001",
"product_type": "FOOTWEAR"
}
],
"query": "air max",
"total": 37,
"country": "us",
"category": null,
"currency": "USD",
"page_size": 24,
"sort_scope": "catalog",
"total_pages": 2,
"removed_by_filter": 30
},
"meta": {
"credits": 1,
"billable": true,
"endpoint_family": "search"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Not Found
No product matches the request. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "search"
},
"error": {
"code": "NOT_FOUND",
"message": "The requested resource was not found."
},
"success": false
}Validation Error
A parameter is missing or invalid. This response is not billable.
{
"errors": {
"query": [
"Send a query or a category."
]
},
"message": "The request validation failed"
}Upstream Unavailable
Nike could not be reached, or it returned data that does not match the request. This response is not billable. Retry shortly.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "search"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "Nike could not be reached. Please retry shortly."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.