# Foot Locker — 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.

> Access product listings, pricing, availability, customer reviews, release calendars, and category/brand browsing data from Foot Locker.

**Category:** E-commerce | **Website:** [footlocker.com/](https://footlocker.com/) | **Docs:** [parse.bot/marketplace/e3ebcbfc-989a-4e59-96ae-f48d36456995/footlocker-com-api](https://parse.bot/marketplace/e3ebcbfc-989a-4e59-96ae-f48d36456995/footlocker-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/foot-locker/`
**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 brand products

Browse products for a specific brand. Returns paginated product listings (48 per page). Brand name is converted to a URL slug internally (e.g., 'Nike' becomes 'nike', 'New Balance' becomes 'new-balance').

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `brand` | string | Yes | Brand name (e.g., 'Nike', 'Jordan', 'Adidas', 'New Balance', 'Puma') |
| `page` | integer | No | Page number (1-indexed) |

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

### Get category products

Browse products within a specific category path. Returns paginated product listings (48 per page) with the same structure as search results. Category paths correspond to Foot Locker's URL structure.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_path` | string | Yes | Category path: 'mens/shoes', 'womens/shoes', 'womens/clothing', 'kids/shoes', 'mens/clothing' |
| `page` | integer | No | Page number (1-indexed) |

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

### Get new arrivals

Retrieve newly added products across all categories. Returns paginated product listings (48 per page).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number (1-indexed) |

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

### Get product details

Retrieve full product details for a specific item by SKU. Returns structured product data including name, description, brand, pricing variants with availability, and breadcrumb navigation. SKUs can be found in search_products results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `sku` | string | Yes | Product SKU from search results (e.g., '04133050') |

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

### Get product reviews

Retrieve customer reviews for a product by its SKU from Bazaarvoice. Returns up to 20 reviews sorted by most recent submission. Some products may return zero reviews if their Bazaarvoice product ID differs from the SKU.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `sku` | string | Yes | Product SKU (e.g., '04133050'). Use baseProduct SKU from search results for best results. |

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

### Get release calendar

Retrieve the sneaker release calendar showing upcoming and recently launched shoes. Each entry includes brand, name, launch date, price, style/color, gender, available sizes, and reservation status. Returns all scheduled releases in a single page.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/foot-locker/get-release-calendar \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get sale products

Retrieve products currently on sale. Returns paginated product listings (48 per page) including both original and discounted prices.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number (1-indexed) |

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

### Search products

Full-text search over Foot Locker's product catalog. Returns paginated product listings (48 per page) with pricing, images, variants, and basic ratings. Queries match product names and descriptions. Returns a 200 with an empty products array when no results match.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number (1-indexed) |
| `query` | string | Yes | Search keyword (e.g., 'nike air max', 'adidas samba') |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/foot-locker/search-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","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.