# SIR the Label — 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 browse SIR. The Label's fashion products, view detailed product information, check loyalty program benefits, and access help and policy pages. Perfect for exploring the brand's offerings and understanding their customer programs.

**Category:** E-commerce | **Website:** [sirthelabel.com/](https://sirthelabel.com/) | **Docs:** [parse.bot/marketplace/8c5bbcf6-224f-43d4-985e-11bd7a69615f/sirthelabel-com-api](https://parse.bot/marketplace/8c5bbcf6-224f-43d4-985e-11bd7a69615f/sirthelabel-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-sirthelabel-com-api-8c5bbcf6/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_loyalty_program

Get the SIR. Loyalty program configuration including tier structure, point earning rules, referral incentives, and program settings. No authentication required - returns the public program information.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country` | string | No | Country code for localized loyalty info (e.g. 'US', 'AU'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sirthelabel-com-api-8c5bbcf6/get_loyalty_program \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"<string>"}'
```

### get_page

Get the content of a help, policy, or informational page by its handle. Returns the page title, HTML body content, and plain text summary. Useful for shipping info, returns, privacy policy, terms, contact details, etc.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `handle` | string | Yes | Page URL handle/slug. Known pages include: shipping-delivery, privacy-policy, terms-conditions, contact-us, payment-2, store-locator, warehouse-t-cs. |

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

### get_product

Get full product details by handle, including description, all images, size/color options, variant availability and pricing. The handle is the URL slug from search_products results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `handle` | string | Yes | Product URL handle/slug (e.g. 'phillipa-shirt-dress-eira-midnight'). Available from search_products results[*].handle. |

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

### search_products

Search products on SIR. The Label using full-text search with faceted filtering and pagination. Returns matching products with pricing, availability, images, and facet breakdowns for further filtering.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `query` | string | Yes | Search query text (e.g. 'dress', 'silk top', 'midi skirt'). |
| `results_per_page` | integer | No | Number of results per page. |
| `sort_direction` | string | No | Sort direction. Accepts: asc, desc. |
| `sort_field` | string | No | Field to sort by. Accepts: relevance, ss_days_since_published, ga_unique_purchases, ss_price. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sirthelabel-com-api-8c5bbcf6/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>","results_per_page":"<integer>","sort_direction":"<string>","sort_field":"<string>"}'
```