theknot.com APItheknot.com ↗
Access The Knot wedding platform data: search couples by name, retrieve registry details, find vendors by category and location, and get vendor storefronts.
curl -X GET 'https://api.parse.bot/scraper/22b89a1a-43b7-4a51-b36c-03a56835dbc4/search_couples?last_name=Smith&first_name=John' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for wedding couples by name. Returns matching couple records with registry URLs and event details.
| Param | Type | Description |
|---|---|---|
| limit | integer | Max results to return |
| last_name | string | Last name of a couple member. Omitting returns all matches for first_name. |
| first_namerequired | string | First name of a couple member (required, cannot be empty) |
{
"type": "object",
"fields": {
"total": "integer total number of matching records",
"records": "array of couple objects with id, firstName, lastName, fianceFirstName, fianceLastName, eventDate, city, state, gvrUrl"
},
"sample": {
"data": {
"total": 261,
"records": [
{
"id": "72758062",
"city": "Chicago",
"state": "IL",
"gvrUrl": "https://registry.theknot.com/john-smith-john-smith-june-2026/72758062",
"wwsUrl": null,
"country": null,
"lastName": "Smith",
"location": "Other",
"eventDate": "2026-06-25T00:00:00.000Z",
"firstName": "John",
"isHiddenDate": false,
"fianceLastName": "Smith",
"fianceFirstName": "John",
"hasTransactionalRegistry": false
}
]
},
"status": "success"
}
}About the theknot.com API
This API exposes 5 endpoints covering The Knot's wedding planning data, from couple registry lookups to vendor discovery. Use search_couples to find wedding couples by first and last name and retrieve their registry URLs, event dates, and locations. Vendor endpoints let you search by category slug and location, then pull full storefront details — including pricing, ratings, and descriptions — for any matching vendor UUID.
Couple and Registry Data
The search_couples endpoint accepts a required first_name and optional last_name, returning an array of couple records that each include id, firstName, lastName, fianceFirstName, fianceLastName, eventDate, city, state, and a gvrUrl pointing to the couple's registry page. That gvrUrl feeds directly into get_couple_registry, which returns the full registry object: couple identifiers (coupleId, coupleUuid), event date, location fields, and a registries array listing the retailer-level registry objects the couple has set up.
Vendor Search and Details
search_vendors accepts a category slug (e.g. wedding-reception-venues, wedding-photographers), a location slug in city-state format (e.g. houston-tx), and a page parameter for pagination. It returns the total vendors found on that page, along with a vendors array where each object carries a UUID id, name, starting_price, rating, review_count, and url. Those UUIDs unlock the two detail endpoints.
Vendor Storefront and Similarity
get_vendor_details takes a vendor_id UUID and returns a storefront object with fields including name, description, headline, websiteUrl, location, reviewSummary, pricing, and categories. get_similar_vendors accepts the same UUID plus an optional limit, and returns a similarity object containing a profiles array — each profile mirrors the storefront shape with id, name, description, location, reviewSummary, and pricing. This makes it straightforward to build recommendation flows or category-level competitor maps.
- Look up a wedding couple by name to retrieve their registry URL and linked retailer registries for gift-planning apps
- Build a venue comparison tool by querying search_vendors with the wedding-reception-venues category slug and a city-state location
- Aggregate vendor starting prices and ratings across a location to generate cost-of-wedding estimates
- Surface similar vendors alongside a selected storefront using get_similar_vendors for a wedding marketplace recommendation feature
- Extract vendor website URLs and descriptions from get_vendor_details to populate a curated vendor directory
- Monitor event dates and couple locations from search_couples results for wedding industry lead generation research
- Paginate through vendor listings in a specific category to build a complete vendor index for a given metro area
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.