# Teepublic — 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 products from TeePublic's print-on-demand marketplace, discover artists and their designs, and explore product types and featured creators. Get detailed information about specific products, artist profiles, and curated collections to find the perfect custom apparel and merchandise.

**Category:** Marketplaces | **Website:** [teepublic.com/](https://teepublic.com/) | **Docs:** [parse.bot/marketplace/4df35cfe-e99a-4d21-94a0-298bb501697c/teepublic-com-api](https://parse.bot/marketplace/4df35cfe-e99a-4d21-94a0-298bb501697c/teepublic-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-teepublic-com-api-4df35cfe/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_artist_designs

List designs from a specific artist's storefront. Returns paginated product listings belonging to one artist. The username is the path segment from the artist's profile URL.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `username` | string | Yes | The artist's username as it appears in their profile URL. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-teepublic-com-api-4df35cfe/get_artist_designs \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","username":"<string>"}'
```

### get_artist_profile

Retrieve public profile information for an artist by username. Returns display name, biography, avatar image URL, and external social media links. The username is the path segment from the artist's profile URL (teepublic.com/user/<username>).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `username` | string | Yes | The artist's username as it appears in their profile URL (e.g. thepeachfuzz from teepublic.com/user/thepeachfuzz). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-teepublic-com-api-4df35cfe/get_artist_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"<string>"}'
```

### get_featured_artists

Retrieve the weekly curated list of featured artists/designers. Returns artist usernames, profile URLs, avatar images, and social media links for each featured creator.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-teepublic-com-api-4df35cfe/get_featured_artists \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_product_details

Retrieve full details for a single product by its URL or path slug. Returns structured pricing, available sizes, colors, fits, styles, artist info, description, and related product variants. The URL can be a full absolute URL or a relative path starting with /.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | The full URL or path slug of the product page (e.g. https://www.teepublic.com/t-shirt/12345678-example-design-title or /t-shirt/12345678-example-design-title). |

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

### list_product_types

List available product types and topic categories extracted from the site navigation. Returns slugs suitable for use in search_products product_type parameter and topic-filtered browsing URLs.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-teepublic-com-api-4df35cfe/list_product_types \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_products

Full-text search over TeePublic products by keyword. Results are scoped to a product type (defaults to t-shirts) and ordered by the chosen sort. Paginates via integer page number. Each result includes title, price, artist name, and image URL.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `product_type` | string | No | Product type slug to search within. Common values: t-shirts, hoodie, mug, hats, kids-t-shirt, socks, bags. |
| `query` | string | Yes | Search keyword. |
| `sort` | string | No | Sort order for results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-teepublic-com-api-4df35cfe/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","product_type":"<string>","query":"<string>","sort":"<string>"}'
```