# Nike (China) — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search Nike China's catalog to find products, check availability, browse specific categories like men's, women's, and kids' shoes, and discover trending items and new arrivals. Get detailed product information including sizes, pricing, and specifications to help with shopping decisions and market research.

**Category:** E-commerce | **Website:** [nike.com.cn/](https://nike.com.cn/) | **Docs:** [parse.bot/marketplace/7f5920b8-0a8f-4b3b-8ad9-0befebe2f722/nike-com-cn-api](https://parse.bot/marketplace/7f5920b8-0a8f-4b3b-8ad9-0befebe2f722/nike-com-cn-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-nike-com-cn-api-7f5920b8/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_hot_search_terms

Get trending search terms from Nike China. Returns up to 8 popular search keywords currently trending on the site. Useful for discovering popular products.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nike-com-cn-api-7f5920b8/get_hot_search_terms \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_jordan_shoes

Get Jordan brand men's shoe listings from Nike China. Returns the default first page of men's Jordan shoes with product details, pricing, and images.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nike-com-cn-api-7f5920b8/get_jordan_shoes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_kids_shoes

Get kids' shoe listings from Nike China. Returns the default first page of kids' shoes with product details, pricing, and images.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nike-com-cn-api-7f5920b8/get_kids_shoes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_mens_shoes

Get men's shoe listings from Nike China. Returns the default first page of men's shoes with product details, pricing, and images.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nike-com-cn-api-7f5920b8/get_mens_shoes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_new_arrivals

Get latest new product arrivals from Nike China. Returns the default first page of new arrivals with product details, pricing, and images.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nike-com-cn-api-7f5920b8/get_new_arrivals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_product_detail

Get full product details by style number. Returns comprehensive product information including pricing, images, sizes, features, specs, and color variants. The style number is found in search or listing results as productCode.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | Product style number (e.g., 'IB1873-102', 'DD1503-101') from search_products or listing results (products[*].productCode). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nike-com-cn-api-7f5920b8/get_product_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"id":"<string>"}'
```

### get_product_listings

Get paginated product listings for a specific category path on Nike China. Returns products with pricing, images, and facet filters. Use anchor parameter to paginate through results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `anchor` | integer | No | Starting index for pagination. |
| `count` | integer | No | Number of items to return per page. |
| `filters` | string | No | Comma-separated attributeIds for filtering (e.g., '16633190-45e5-4830-a068-232ac7aea82c'). |
| `path` | string | Yes | Category path (e.g., '/w/mens-shoes-nik1zy7ok', '/w/womens-shoes-5e1x6zy7ok'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nike-com-cn-api-7f5920b8/get_product_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"anchor":"<integer>","count":"<integer>","filters":"<string>","path":"<string>"}'
```

### get_product_sizes

Get real-time size availability for a product group. Returns each size with availability status (isAvailable boolean) and inventory level (ship: HIGH/MEDIUM/LOW/OOS). The group_key comes from search or detail results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `group_key` | string | Yes | Product group key from search_products results (products[*].groupKey) or get_product_detail (groupKey). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nike-com-cn-api-7f5920b8/get_product_sizes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"group_key":"<string>"}'
```

### get_running_shoes

Get running shoe listings from Nike China. Returns the default first page of running shoes with product details, pricing, and images.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nike-com-cn-api-7f5920b8/get_running_shoes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_womens_shoes

Get women's shoe listings from Nike China. Returns the default first page of women's shoes with product details, pricing, and images.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nike-com-cn-api-7f5920b8/get_womens_shoes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_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.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword (e.g., 'dunk', 'jordan', 'air force 1'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nike-com-cn-api-7f5920b8/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```