# Nike — 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 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. Each call is automatically billed to your wallet in USDC.

## Access

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

## 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.paywithlocus.com/api/wrapped/parse-nike-com-api-90b85fc4/get_deals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-nike-com-api-90b85fc4/get_product_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-nike-com-api-90b85fc4/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-nike-com-api-90b85fc4/search_suggestions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"count":"<integer>","country":"<string>","language":"<string>","query":"<string>"}'
```