Search or browse Nike products API

Endpoint facts

Method

GET

API path

/nike/search

Auth

apiKey

Credits

3 credits/request

Platform

Nike

Response schema

#/definitions/nike.searchResponseDoc

Overview

Searches Nike.com product listings by keyword, or browses a category/subcategory listing by slug, with real pagination. Exactly one of keyword or category is required. Returns normalized product groups with pricing, colorway images, and every purchasable color variant, plus filter and subcategory navigation data (facet_nav) already present on the same response -- both keyword search and a category listing's first page include filter groups (Gender, Color, Price, Size, and similar); only a category listing includes a breadcrumb trail and subcategory drill-down options, and only its first page (a category listing's later pages do not repeat navigation data). Keyword search is best-effort relevance, not a guaranteed keyword match: for an obscure or nonsense keyword, Nike's own search index falls back to its own recommended results instead of returning an empty list, and there is currently no reliable signal in the response to distinguish a true keyword match from that fallback behavior. A keyword Nike's own search router treats as structurally empty (for example a punctuation-only query) does return a genuine empty result. Category values come from nike-categories' own slug field, or from a prior response's own facet_nav navigation paths (with the leading /w/ stripped). Requesting a page beyond the available result pages returns a not-found error. Developers commonly use this endpoint for data enrichment, monitoring, research dashboards, internal automation, and agent-native workflows that need repeatable structured public web data. Authentication uses the documented Crawlora headers, and usage is metered with the credit cost shown on this page.

Authentication

Send your scraping API key in the x-api-key header. Use the console API Keys page to rotate or select the active key.

Billing

Endpoint usage is metered in credits. The plan prices, included credits, limits, and overage rates below match the active backend billing configuration.

Credit cost

3 credits/request

Charged response

Successful 2xx responses

Infrastructure behavior

This endpoint is executed through Crawlora's managed scraping infrastructure.

• Proxy strategy: managed automatically where needed
• Browser rendering: enabled for supported targets that require rendered HTML or JavaScript execution
• Browser cluster: supported dynamic workloads can be routed through distributed browser instances
• Retry behavior: automatic retry/fallback may be used depending on endpoint type
• Challenge handling: challenged pages or unusable upstream HTML are detected and surfaced clearly when they cannot be used
• Billing: credits are charged only for successful 2xx responses
• Observability: responses include request context where available

Response behavior

- Keyword search is best-effort relevance, not a guaranteed keyword match. For an obscure or nonsense `keyword`, Nike's own search index falls back to its own recommended results instead of returning an empty list, and there is currently no reliable field in the response to distinguish a true keyword match from that fallback behavior. - A `keyword` Nike's own search router treats as structurally empty (for example a punctuation-only query) does return a genuine empty result (`count: 0`, `products: []`), distinct from the fallback-results behavior above. - Requesting a `page` beyond the number of pages Nike itself reports (`total_pages`) returns a not-found error rather than an empty page. - Each product group's `colors[].slug` and `colors[].style_color` are the values to pass as `slug`/`style_color` to `nike-product` for full product-detail data on that color. - `facet_nav` is present when Nike's own response carries navigation data: `categories[]` (subcategory drill-down options, each with a live `result_count` and a `path` usable as a future request's `category` value), `filters[]` (named filter groups such as Gender, Color, Shop by Price, Size, Brand, each with its own `options[]`), and `breadcrumbs[]` (the category hierarchy trail, e.g. Jordan > Shoes). Both keyword search and a category listing return `filters[]`; only a category listing returns `categories[]`/`breadcrumbs[]`. `facet_nav` is present only on a category listing's first page -- later pages of the same category browse do not repeat navigation data (Nike's own upstream omits it once a page requires the internal parameter this endpoint uses to keep pagination correctly scoped past page 1). ```json {"code":200,"msg":"OK","data":{"keyword":"running shoes","page":1,"page_size":24,"count":2,"total_pages":14,"total_products":315,"products":[{"group_key":"l11miwwa","title":"Nike Vomero Premium","subtitle":"Men's Road Running Shoes","product_type":"FOOTWEAR","colors":[{"slug":"vomero-premium-mens-road-running-shoes-l11miwwa","style_color":"HQ2050-102","color_label":"White","color_description":"White/Green Spark/Summit White/Midnight Navy","currency":"USD","price":230,"initial_price":230,"image_url":"https://static.nike.com/a/images/squarish1.png","url":"https://www.nike.com/t/vomero-premium-mens-road-running-shoes-l11miwwa/HQ2050-102"}]},{"group_key":"Z4kCQRR6","title":"Nike Structure 26","subtitle":"Women's Road Running Shoes","product_type":"FOOTWEAR","badge_label":"Best Seller","colors":[{"slug":"structure-26-womens-road-running-shoes-Z4kCQRR6","style_color":"HJ1101-501","color_label":"Purple","color_description":"Purple/Barely Grape","currency":"USD","price":140,"initial_price":140,"image_url":"https://static.nike.com/a/images/squarish3.png","url":"https://www.nike.com/t/structure-26-womens-road-running-shoes-Z4kCQRR6/HJ1101-501"}]}]}} ``` A category-browse request (`category=mens-jordan-shoes-37eefznik1zy7ok`) returns the same shape with `facet_nav.breadcrumbs` populated: ```json {"code":200,"msg":"OK","data":{"category":"mens-jordan-shoes-37eefznik1zy7ok","page":1,"page_size":24,"count":24,"total_pages":5,"total_products":100,"products":[{"title":"Air Jordan 6 Retro \"Oreo\"","subtitle":"Men's Shoes","colors":[{"slug":"air-jordan-6-retro-oreo-mens-shoes-mVJLdEz6","style_color":"CT8529-108"}]}],"facet_nav":{"categories":[{"label":"Jordan 1","path":"/w/jordan-1-shoes-37eefz3rknz5e1x6zy7ok","result_count":38}],"filters":[{"name":"Gender","options":[{"label":"Men","path":"/w/shoes-37eef","result_count":100,"selected":true}]}],"breadcrumbs":[{"name":"Jordan","path":"/w/jordan-37eef"},{"name":"Shoes","path":"/w/jordan-shoes-37eefzy7ok"}]}}} ```

Error behavior

Crawlora does not silently return bad data when the upstream page cannot be used.

When possible, Crawlora returns structured error context so your integration can retry, back off, or inspect the request.

Related