# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/nike-china/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/nike-china/get-hot-search-terms \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/nike-china/get-jordan-shoes \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/nike-china/get-kids-shoes \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/nike-china/get-mens-shoes \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/nike-china/get-new-arrivals \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/nike-china/get-product-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/nike-china/get-product-listings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/nike-china/get-product-sizes \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/nike-china/get-running-shoes \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/nike-china/get-womens-shoes \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/nike-china/search-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.