💍 The Knot Wedding Couple Enrichment Scraper

🚀 Turn a couple's name into their full public wedding profile in seconds. Input a first and last name, get back both partners, wedding date, city and state, venue, wedding website, and registry, up to 22 fields per record.

The Knot Wedding Couple Enrichment Scraper looks up the information a couple has already chosen to publish on their public The Knot wedding website and returns it as clean, structured data. You provide a first name and a last name (for example a guest, vendor, or planner who already knows the couple), and the Actor returns every matching public couple: both partners' names, the wedding date, the city and state, the venue (when the couple added it), the wedding website URL, and the gift registry URL.

This is an enrichment tool, not a discovery or contact-list tool. It does not browse or dump a directory of strangers. It resolves a name you already have into the public wedding details that The Knot itself displays on its open "Find a Couple" search, then structures them so you can drop them into a spreadsheet or CRM instead of copying by hand.

📋 What the Actor does

1. Takes a first name and last name (both required, minimum 2 characters each).
2. Queries The Knot's public "Find a Couple" search (theknot.com/registry/couplesearch).
3. Returns every matching public couple with both partners' names, wedding date, city, state, country, wedding website URL, and registry URL.
4. Optionally enriches each result with venue details (venue name, address, ceremony and reception locations) by reading the couple's own public wedding-website page. Venue is included only when the couple has filled it in.
5. Optional filters narrow results by wedding month and year.

🔀 Two modes

The Actor runs in one of two modes, set by the mode input:

• Search mode (default): look up a name you already have. Provide firstName and lastName (optionally eventMonth / eventYear) and get back the matching public couples.
• Discover mode: for when you do not have a name yet. It browses The Knot's public couple directory and applies optional filters, usState and a weddingDateFrom / weddingDateTo range, with maxScan capping how many public IDs the run walks. It walks the newest public couple IDs downward, so the most recent and upcoming weddings come back first. onlyComplete pairs well with discover to drop sparse records. Like search mode, it reads only public pages.

{"mode":"discover","usState":"TX","maxScan":5000,"includeVenue":true,"maxItems":500}

📊 Data fields

Each record includes: ceremonyVenue, city, country, coupleId, coupleNames, hasTransactionalRegistry, isHiddenDate, location, partner1FirstName, partner1LastName, partner2FirstName, partner2LastName, receptionVenue, registryUrl, scrapedAt, state, venueAddress, venueCity, venueName, venueState, weddingDate, weddingLocationText, weddingWebsiteUrl, zip. All 24 field names come from a real production run, so what you see here is what lands in your dataset.

⚠️ Good to Know: The Knot requires both a first name and a last name to return results, one for each partner is fine. A name alone can match many couples, so use the month and year filters to narrow down. Venue, address, and ceremony or reception details appear only when the couple filled them in on their own public wedding website, so these fields are often blank. That is expected, not an error.

🚀 How to use

1. Sign up for a free Apify account using this link.
2. Open the Actor and enter a first name and last name.
3. (Optional) Add a wedding month and year to narrow results, and keep Include venue details on.
4. Click Start and wait for the run to finish.
5. Export your results as CSV, Excel, JSON, or XML from the dataset tab.

🔗 Recommended Actors

• Other lead and directory enrichment Actors by ParseForge
• Registry and gifting data Actors
• Local business and venue data Actors

💡 Pro Tip: browse the complete ParseForge collection.

⚠️ Disclaimer: This is an independent tool and is not affiliated with, endorsed by, or sponsored by The Knot or The Knot Worldwide. It collects only publicly available data that couples have chosen to publish on their public wedding websites and The Knot's public couple search. Use the data responsibly and in compliance with applicable laws, including privacy and anti-spam regulations. Do not use it to contact individuals who have not consented to be contacted.

🆘 Need Help?

If you hit a bug, have questions about setup, or need a scraper we haven't built yet, open our contact form or write to parseforge@protonmail.com. We also take on paid custom data projects.

For faster answers, join our Discord. It's the best place to get support and suggest new actors.