# Theknot — 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 for wedding couples and vendors on The Knot wedding platform. Retrieve couple registry details, vendor listings with pricing and service information, and discover similar vendors by category and location.

**Category:** Marketplaces | **Website:** [theknot.com/](https://theknot.com/) | **Docs:** [parse.bot/marketplace/cbbe1b68-2f76-42ff-a033-a791dac57066/theknot-com-api](https://parse.bot/marketplace/cbbe1b68-2f76-42ff-a033-a791dac57066/theknot-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-theknot-com-api-cbbe1b68/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_couple_registry

Retrieve full wedding registry details for a couple by their registry page URL (gvrUrl from search_couples). Returns couple identity, event date, location, and an array of linked retail registries with retailer info.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `registry_url` | string | Yes | The Knot registry URL from search_couples results gvrUrl field (e.g. https://registry.theknot.com/john-smith-jenny-mcconnell-march-2025/42697905) |

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

### get_similar_vendors

Retrieve vendors similar to a given vendor by UUID (from search_vendors id field). Returns profiles with name, description, location, review summary, and pricing via the GraphQL marketplace API.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Max number of similar vendors to return |
| `vendor_id` | string | Yes | Vendor UUID from search_vendors results id field (e.g. e90edeb6-93ba-41f4-b728-b22a0d807a0b) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-theknot-com-api-cbbe1b68/get_similar_vendors \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","vendor_id":"<string>"}'
```

### get_vendor_details

Retrieve detailed storefront information for a vendor by UUID (from search_vendors id field). Returns full business description, location address, review summary, pricing range, website URL, and categories via the GraphQL marketplace API.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `vendor_id` | string | Yes | Vendor UUID from search_vendors results id field (e.g. e90edeb6-93ba-41f4-b728-b22a0d807a0b) |

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

### search_couples

Full-text search for wedding couples by first and last name. Returns matching couple records with registry URLs, event dates, and locations. Minimum page size enforced by upstream is 20; values below that are clamped. Each record includes a gvrUrl usable in get_couple_registry for full registry details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `first_name` | string | Yes | First name of a couple member (required, cannot be empty) |
| `last_name` | string | No | Last name of a couple member. Omitting returns all matches for first_name. |
| `limit` | integer | No | Max results to return (minimum 20 enforced by upstream) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-theknot-com-api-cbbe1b68/search_couples \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"first_name":"<string>","last_name":"<string>","limit":"<integer>"}'
```

### search_vendors

Search for wedding vendors by category and location. Returns a page of vendor listings parsed from the marketplace directory. Each vendor includes a UUID usable in get_vendor_details and get_similar_vendors, plus rating, review count, starting price, and storefront URL when available. 30 vendors per page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Vendor category slug (e.g. wedding-reception-venues, wedding-photographers, wedding-videographers, bridal-salons, beauty-services, wedding-djs, live-wedding-bands, florists, wedding-planners, wedding-room-blocks, jewelers, wedding-cake-bakeries, bar-services, catering) |
| `location` | string | No | Location slug in city-state format (e.g. houston-tx, new-york-ny, los-angeles-ca) |
| `page` | integer | No | Page number for pagination (1-based) |

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