# Nike — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 the Nike product catalog by keyword and retrieve detailed product information including pricing, sizing, color variants, and availability. Use autocomplete suggestions to refine queries and discover relevant products on Nike.com.

**Category:** E-commerce | **Website:** [www.nike.com/](https://www.nike.com/) | **Docs:** [parse.bot/marketplace/90b85fc4-4122-48c3-ba28-b4e6f516d921/nike-com-api](https://parse.bot/marketplace/90b85fc4-4122-48c3-ba28-b4e6f516d921/nike-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/nike/`
**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 deals

Fetches current deals and sale/discounted products from Nike Poland (nike.com/pl). Returns paginated product summaries with current and previous prices, discount percentages, and images. Each page contains up to `count` items (24, 50, or 100). Results are sorted by Nike's default sale ranking.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `count` | integer | No | Products per page. Must be 24, 50, or 100. Other values are rounded to nearest valid option. |
| `page` | integer | No | Page number (1-based) |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/nike/get-deals \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"count":"<integer>","page":"<integer>"}'
```

### Get product details

Fetches full product information for a single Nike product including available sizes, description, features, benefits, color variants, and images. Accepts either a full Nike product URL or a style-color code (the alphanumeric identifier like 'IB1873-110'). Returns a single product with all detail fields populated.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_url` | string | No | Full Nike product URL (e.g., 'https://www.nike.com/t/vomero-premium-mens-road-running-shoes-l11miwwa/HQ2050-101'). Either product_url or style_color is required. |
| `style_color` | string | No | Nike style-color code (e.g., 'IB1873-110'). Either product_url or style_color is required. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/nike/get-product-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"product_url":"<string>","style_color":"<string>"}'
```

### Search products

Full-text search over Nike's product catalog. Returns paginated product summaries with prices, colors, images, and links. Pagination via page number; each page contains up to `count` items. Only the US marketplace with English language is confirmed working.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `count` | integer | No | Products per page. Must be 24, 50, or 100. Other values are rounded to nearest valid option. |
| `language` | string | No | Language code. Only 'en' is confirmed working. |
| `marketplace` | string | No | Marketplace/country code. Only 'US' is confirmed working. |
| `page` | integer | No | Page number (1-based) |
| `query` | string | Yes | Search keyword (e.g., 'running shoes', 'air max', 'basketball shoes') |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/nike/search-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"count":"<integer>","language":"<string>","marketplace":"<string>","page":"<integer>","query":"<string>"}'
```

### Search suggestions

Returns autocomplete suggestions for a partial search query. Useful for building search-as-you-type UIs. Each suggestion includes display text and the corresponding search text to submit. Only the US country with English language is confirmed working.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `count` | integer | No | Maximum number of suggestions to return |
| `country` | string | No | Country code. Only 'US' is confirmed working. |
| `language` | string | No | Language code. Only 'en' is confirmed working. |
| `query` | string | Yes | Partial search text to get suggestions for |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/nike/search-suggestions \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"count":"<integer>","country":"<string>","language":"<string>","query":"<string>"}'
```

## Next steps

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