# Zazzle — 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.

> Browse and search Zazzle's marketplace to discover personalized and custom products, view detailed product information including pricing and specifications, and explore available product categories. Access product details to compare options and find exactly what you're looking for across Zazzle's wide selection of customizable items.

**Category:** Marketplaces | **Website:** [www.zazzle.com/](https://www.zazzle.com/) | **Docs:** [parse.bot/marketplace/d0355470-60cd-4ec2-8ed6-fcf2d6e9da68/zazzle-com-api](https://parse.bot/marketplace/d0355470-60cd-4ec2-8ed6-fcf2d6e9da68/zazzle-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-zazzle-com-api-d0355470/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_categories

Browse a Zazzle product category. Returns paginated product listings within the category and links to subcategories. Results are auto-iterated by the SDK.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category slug from the URL path (e.g. 'gifts', 'home+living', 'clothing', 'coffee+mugs'). |
| `page` | integer | No | Page number for pagination (1-based). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-zazzle-com-api-d0355470/get_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","page":"<integer>"}'
```

### get_product_details

Retrieve full details for a single product including description, pricing, brand information, and category breadcrumbs. Requires the product URL from search results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_url` | string | Yes | Full Zazzle product URL or path (from search_products results[*].url). |

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

### search_products

Full-text search across Zazzle's marketplace. Returns paginated product listings sorted by the chosen criterion. Each page contains up to 60 products. Results are auto-iterated by the SDK.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (1-based). |
| `query` | string | Yes | Search terms for products (e.g. 'coffee mug', 'wedding invitation'). |
| `sort` | string | No | Sort order for search results. |

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