# Stadium Goods — 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 and discover premium sneakers and streetwear from Stadium Goods. Retrieve detailed product specifications, variant-level pricing, and real-time inventory status across the full catalog and curated collections.

**Category:** Marketplaces | **Website:** [stadiumgoods.com/](https://stadiumgoods.com/) | **Docs:** [parse.bot/marketplace/7f5e0adf-e1a2-431c-8a44-773dd880cf0c/stadiumgoods-com-api](https://parse.bot/marketplace/7f5e0adf-e1a2-431c-8a44-773dd880cf0c/stadiumgoods-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-stadiumgoods-com-api-7f5e0adf/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_product_details

Retrieve full details for a single product by its URL handle. Returns comprehensive product information including all variants with sizing, pricing, SKUs, inventory availability, all images, options, and HTML description. The handle is the URL slug obtainable from search_products or list_products results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `handle` | string | Yes | Product handle (URL slug), obtainable from search_products.products[*].handle or list_products.products[*].handle. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-stadiumgoods-com-api-7f5e0adf/get_product_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"handle":"<string>"}'
```

### list_collections

Paginated listing of product collections (brands, categories) available on Stadium Goods. Returns collection names, handles, descriptions, and product counts. Collections are ordered alphabetically by title.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of collections per page (1-250). |
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-stadiumgoods-com-api-7f5e0adf/list_collections \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>"}'
```

### list_products

Paginated listing of all products in the Stadium Goods catalog. Returns full product details including all variants with sizing, pricing, SKUs, images, and metadata. Each page contains up to `limit` products ordered by the site's default (recently published first).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of products per page (1-250). |
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-stadiumgoods-com-api-7f5e0adf/list_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>"}'
```

### list_products_by_collection

Paginated listing of products within a specific collection identified by its handle. Returns the same full product details as list_products, scoped to a single collection (brand or category). Some collections may be empty if their products are unlisted.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `collection_handle` | string | Yes | Collection handle (URL slug), obtainable from list_collections.collections[*].handle. |
| `limit` | integer | No | Number of products per page (1-250). |
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-stadiumgoods-com-api-7f5e0adf/list_products_by_collection \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"collection_handle":"<string>","limit":"<integer>","page":"<integer>"}'
```

### search_products

Full-text search over the Stadium Goods catalog via Shopify suggest. Returns products matching the query with title, handle, pricing range, vendor, availability, and a single representative variant. Limited to 10 results maximum per query.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results to return (1-10). |
| `query` | string | Yes | Search keyword or SKU to look up (e.g. 'Jordan 1', 'Nike Dunk', 'DQ8426'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-stadiumgoods-com-api-7f5e0adf/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","query":"<string>"}'
```