# Nike Search API Documentation
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.
- **Documentation:** [https://scrappa.co/docs/nike-api/nike_search](https://scrappa.co/docs/nike-api/nike_search)
- **API group:** Nike API
- **Endpoint:** `GET https://scrappa.co/api/nike/search`
## Authentication
Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.
## Parameters
| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | No | Search keyword. Send query or category. |
| `category` | string | No | shoes, clothing, tops, shorts, hoodies, jackets, pants, fleece, tracksuits, underwear, swimwear or socks. Send query or category. |
| `gender` | string | No | men, women, unisex, boys or girls. |
| `size` | string | No | Size label of the country site, for example 10 or M 10 / W 11.5 for shoes and M for clothing. |
| `color` | string | No | black, blue, brown, green, grey, multi-color, orange, pink, purple, red, white or yellow. |
| `price_min` | number | No | Lowest current price in the currency of the country. |
| `price_max` | number | No | Highest current price in the currency of the country. |
| `sale_only` | boolean | No | true returns only colorways with a sale price. |
| `sort` | string | No | relevance (default), newest, price_asc or price_desc. Price sorts order the returned page by current price. |
| `page` | integer | No | One-based page number, 1 to 100 (default 1). A page has up to 24 product groups. |
| `country` | string | No | Country: us (default), de, fr, gb or jp. |
## Example response
```json
{
"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
| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | No product matches the request. This response is not billable. |
| 422 | Validation Error | A parameter is missing or invalid. This response is not billable. |
| 503 | Upstream Unavailable | Nike could not be reached, or it returned data that does not match the request. This response is not billable. Retry shortly. |
## More Scrappa resources
- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)