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

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

## Access

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

## 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.paywithlocus.com/api/wrapped/parse-footlocker-com-api-e3ebcbfc/get_brand_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-footlocker-com-api-e3ebcbfc/get_category_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-footlocker-com-api-e3ebcbfc/get_new_arrivals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-footlocker-com-api-e3ebcbfc/get_product_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-footlocker-com-api-e3ebcbfc/get_product_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-footlocker-com-api-e3ebcbfc/get_release_calendar \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-footlocker-com-api-e3ebcbfc/get_sale_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-footlocker-com-api-e3ebcbfc/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```