Com APInike.com.cn ↗
Access Nike China product listings, search results, size availability, pricing, and category browsing via the nike.com.cn API. 11 endpoints.
What is the Com API?
The Nike China API provides structured access to nike.com.cn catalog data across 11 endpoints, covering product search, category listings, size availability, and product detail. The get_product_detail endpoint returns pricing in CNY with discount percentages, full size arrays with availability status, feature descriptions, and spec sheets — data points that are tedious to collect manually across Nike's China storefront.
curl -X GET 'https://api.parse.bot/scraper/493682aa-31b6-4869-a47b-0d5f111e2dd8/search_products?query=dunk' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace nike-com-cn-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Nike China API — search, browse categories, drill into details and sizes."""
from parse_apis.nike_china_api import NikeChina, Path, ProductNotFound
client = NikeChina()
# Search for products by keyword — limit= caps TOTAL items fetched.
for product in client.products.search(query="dunk", limit=3):
print(product.title, product.price.current, product.price.currency)
# Browse trending search terms to discover what's popular.
for term in client.searchterms.list(limit=5):
print(term.display_text, term.search_text)
# Drill into a single product's full details via .first() then .get().
hit = client.products.jordan(limit=1).first()
if hit:
detail = client.productdetails.get(style_color=hit.product_code)
print(detail.title, detail.subtitle, detail.prices.current_price)
# Check size availability on that product.
availability = detail.sizes()
for sz in availability.sizes[:3]:
print(sz.localized_label, sz.ship, sz.is_available)
# Browse a custom category path using the constructible Category resource.
category = client.category(path=Path._W_RUNNING_SHOES_37V7JZY7OK)
for shoe in category.list_products(limit=3):
print(shoe.title, shoe.subtitle, shoe.price.current)
# Typed error handling for a missing product.
try:
client.productdetails.get(style_color="XX0000-999")
except ProductNotFound as exc:
print(f"Product not found: {exc}")
print("exercised: products.search / searchterms.list / products.jordan / productdetails.get / detail.sizes / category.list_products")Search for products by keyword on Nike China. Returns matching products with pricing, images, and facet filters for navigation. Paginates via the site's internal SSR wall; returns all results for the query in one page.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search keyword (e.g., 'dunk', 'jordan', 'air force 1'). |
{
"type": "object",
"fields": {
"query": "string — the search query echoed back",
"total": "integer or null — total matching products",
"facets": "object — facet navigation with categories, breadcrumbs, and filters",
"products": "array of product summaries with title, subtitle, productCode, groupKey, price, colors, images, url, path, badges"
},
"sample": {
"data": {
"query": "dunk",
"total": 175,
"facets": {
"filters": [],
"categories": []
},
"products": [
{
"url": "https://www.nike.com.cn/t/dunk-low-AsS6IttM/IM6572-105",
"path": "/t/dunk-low-AsS6IttM/IM6572-105",
"price": {
"current": 669,
"initial": 749,
"currency": "CNY",
"discount_percentage": 10
},
"title": "Nike Dunk Low",
"badges": null,
"colors": {
"count": null,
"description": "帆白/白色/粉白"
},
"images": {
"portrait": "https://static.nike.com.cn/a/images/t_default/87930180.png",
"squarish": "https://static.nike.com.cn/a/images/t_default/2bf37905.png"
},
"groupKey": "AsS6IttM",
"subtitle": "女子运动鞋",
"productCode": "IM6572-105"
}
]
},
"status": "success"
}
}About the Com API
Search and Category Browsing
The search_products endpoint accepts a keyword query (e.g., 'dunk', 'air force 1') and returns matching product summaries including title, subtitle, productCode, groupKey, price, images, badges, and a facets object for filter navigation. The get_product_listings endpoint works similarly but operates on a category path (e.g., /w/mens-shoes-nik1zy7ok) and supports count, anchor, and filters parameters for pagination and attribute-based filtering. The next_anchor field in listing responses points to the next page of results. Convenience endpoints — get_mens_shoes, get_womens_shoes, get_kids_shoes, get_jordan_shoes, get_running_shoes, and get_new_arrivals — return the first page of each respective category with no input required.
Product Detail and Size Availability
get_product_detail accepts a style number such as HQ3048-501 or a URL path slug and returns a full product record: brand, sport, gender, images array, features (header + body pairs), specs, and a prices object with currentPrice, initialPrice, discountPercentage, and employeePrice in CNY. Size data comes back as an array of objects with label, localizedLabel, and status.
For real-time inventory, get_product_sizes takes a group_key (available from search or detail responses) and returns each size with availability.isAvailable, availability.ship, gtin, productCode, and merchSkuId. This separates inventory freshness from static catalog data, so you can call sizes independently without re-fetching the full detail record.
Trending Terms
get_hot_search_terms returns up to 8 trending search keywords from nike.com.cn, each with displayText and searchText fields. This is useful for monitoring what shoppers on the China platform are actively searching, which can differ meaningfully from Nike's global trends.
The Com API is a managed, monitored endpoint for nike.com.cn — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when nike.com.cn changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official nike.com.cn API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Track CNY price changes and discount percentages across Nike China product listings using
get_product_listingswith pagination. - Monitor real-time size availability for specific colorways using
get_product_sizeswith agroupKey. - Build a China-market sneaker search tool backed by
search_productswith keyword queries like'jordan'or'dunk'. - Compare Nike China new arrivals against global releases using
get_new_arrivalsto surface CN-exclusive colorways. - Feed trending keywords from
get_hot_search_termsinto localized marketing or SEO tooling. - Aggregate Jordan brand men's shoe listings using
get_jordan_shoesfor competitive pricing analysis in the CN market. - Collect full spec and feature data from
get_product_detailto populate a product comparison database.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Nike China have an official developer API?+
What does `get_product_sizes` return that `get_product_detail` does not?+
get_product_detail includes a sizes array with label and status, but get_product_sizes returns per-size inventory fields including availability.isAvailable, availability.ship, gtin, productCode, and merchSkuId. Because it targets a groupKey rather than a single style number, it can cover multiple colorways within a product group in one call.How does pagination work for category listings?+
get_product_listings accepts an anchor integer as a starting offset and a count integer for page size. The response includes a next_anchor field — a URL string — that encodes the offset for the following page. If next_anchor is null, there are no further results. The total field tells you the full count of products in that category.Does the API cover nike.com.cn customer reviews or ratings?+
Is the product data limited to shoes, or does it include apparel and accessories?+
search_products and get_product_listings are not restricted to footwear. You can pass any valid nike.com.cn category path to get_product_listings to retrieve apparel or accessories listings. The response shape is identical across categories.