WeddingWire Couple Scraper

WeddingWire Couple Scraper

Scrape WeddingWire couple profiles by name search or by walking public website IDs, up to a million per run. Each record returns partner names, wedding date, location, and website details. No login or API key. Export to CSV, JSON, Excel, or XML.

WeddingWire's couple directory holds millions of public wedding websites, but there is no official API to collect them in bulk. This Actor reads the public directory directly, either by searching for specific names you provide or by walking sequential website IDs to discover couples without any name. It returns each matched couple in one fixed schema, ready for lead lists, market analysis, or invitation campaigns.

Who uses it	What they scrape WeddingWire for
Wedding vendors	Build a targeted list of engaged couples in their service area for direct outreach.
Market researchers	Analyze wedding date trends, geographic distribution, and couple naming patterns across the US.
Event planners	Discover new couples planning weddings in a specific state or date range to pitch services.
Lead generation agencies	Compile fresh, verified couple leads with wedding dates and locations for resale or CRM enrichment.

What it does

This Actor collects WeddingWire couple profiles by name search or sequential ID discovery, and returns each couple as a flat row with partner names, wedding date, location, and website details.

• 🔍 Search by name: Provide one or more partner names (first, last, or full) and get back up to 20 public couples per term from the WeddingWire directory.
• 🚶 Discover by ID walk: Walk WeddingWire's sequential public website IDs to collect couples without any name, starting from a specific ID or a random fresh point.
• 🎲 Randomized discovery: When discover mode runs without a fixed start ID, it picks a random point in the 42M-46M band each run so repeated runs return different couples.
• 🗺️ US state filter: In discover mode, keep only couples whose public location matches a given state (full name or 2-letter code), skipping those with no location.
• 📅 Wedding date range: In discover mode, filter couples to only those with a wedding date falling within a specified ISO date window.
• ✅ Complete leads only: Optionally skip sparse records and keep only couples that have both a partner name and a wedding date, with skipped counts logged.

Results export to CSV, JSON, Excel, or XML, or straight from the API.

What you can do with WeddingWire data

📋 Build a local lead list.

A wedding photographer in Texas runs discover mode with the state filter set to 'TX' and a date range for the next 12 months, collecting hundreds of qualified couple leads with wedding dates and locations.

🔎 Enrich a CRM list.

A bridal shop uploads a list of customer names into search mode, and the Actor returns each matching WeddingWire profile with the couple's wedding date, location, and website welcome message.

📊 Analyze wedding seasonality.

A market researcher runs discover mode across multiple states without a date filter, then aggregates wedding dates by month to identify peak booking seasons for a national campaign.

🔄 Refresh leads on a schedule.

A lead generation agency schedules the Actor weekly with randomized start IDs, pulling fresh couple profiles each run to keep their CRM current with newly engaged couples.

Why choose this scraper

	What you get
No API key needed	Reads WeddingWire's public couple directory directly, no registration or OAuth required.
Two collection modes	Search by specific names to enrich a known list, or walk IDs to discover couples you did not know existed.
Built-in filters	Narrow discover runs by US state, wedding date range, and record completeness before data lands in your dataset.
Scalable volume	Collect up to a million couples per run with a configurable scan budget and item cap.

How it compares

This Actor focuses exclusively on WeddingWire couple profiles, while the competitors below scrape vendor listings across one or more wedding platforms.

Feature	ParseForge	Wedding Vendor Scraper - 7 Sites	WeddingWire Vendor Directory Scraper	Wedding Vendor Scraper - Bridebook, The Knot, WeddingWire, Zola
Scrapes WeddingWire couple profiles	Yes	Not listed	Not listed	Not listed
Scrapes WeddingWire vendor listings	No	Yes	Yes	Yes
Discovery by website ID walk	Yes	Not listed	Not listed	Not listed
Search couples by name	Yes	Not listed	Not listed	Not listed
Multi-site vendor scraping	No	Yes (7 sites)	Not listed	Yes (4 sites)
Wedding date range filter	Yes	Not listed	Not listed	Not listed

Configure the run

Drive the Actor from couple names or sequential website IDs, and apply state, date range, and completeness filters as each profile is read so only matching couples reach your dataset. The Input tab lists every parameter.

A first run with the defaults:

{
 "searchTerms": [
 "Smith"
 ],
 "maxScan": 3000,
 "maxItems": 10
}

A larger pull:

{
 "searchTerms": [
 "Smith"
 ],
 "maxScan": 3000,
 "maxItems": 200
}

Pricing

Pay-per-result: $0.005 per result collected. You pay only for the results written to your dataset.

Results collected	Approximate cost
100 results	$0.50
1,000 results	$5.00
10,000 results	$50.00

New Apify accounts start with $5 in free credit.

Free users

Free-plan runs return up to 10 results as a preview. Upgrade your Apify plan to collect up to 1,000,000 results per run.

Run it

1. Create a free Apify account with $5 in credit.
2. Open the WeddingWire Couple Scraper.
3. Set your inputs and any filters, then click Start.
4. Export the results as CSV, Excel, JSON, or XML from the Dataset tab.

Run it programmatically through the Apify API (run-sync-get-dataset-items) or the ApifyClient for JavaScript and Python.

Use with AI agents (MCP)

Give an AI agent live access to WeddingWire through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:

claude mcp add --transport http apify "https://mcp.apify.com?tools=parseforge/weddingwire-couples-scraper"

Then prompt it in plain language to run the scraper and read back the results.

Troubleshooting

Why am I getting no results in discover mode?

Check your filters. A narrow state filter combined with a tight date range can mean many IDs are walked before a match is found. Try widening the date range, removing the state filter, or increasing the max scan budget. Also confirm your start website ID is in a valid range.

Why does search mode return fewer couples than I expected?

WeddingWire's public directory shows up to 20 couples per search term. If your search term is very common, you may hit that cap. Try more specific names, or switch to discover mode for broader collection.

The run stopped before reaching my max items setting.

In discover mode, the run stops when either max items or max scan budget is reached. If you hit the scan budget first, increase the max IDs to scan value. In search mode, the run stops when all search terms have been exhausted.

Some couple records are missing location or wedding date.

Not every WeddingWire couple fills in their full profile publicly. Enable 'Only complete leads' to skip sparse records, or leave it off to collect everything and filter later in your own tools.

I am getting duplicate couples across runs.

In discover mode without a fixed start ID, enable randomized start to vary the starting point each run. For search mode, deduplicate by the couple's website URL in your downstream processing.

FAQ

Question	Answer
Does this Actor scrape WeddingWire vendors or couples?	This Actor scrapes only WeddingWire couple profiles and their public wedding websites. For vendor data, see the WeddingWire Vendor Directory Scraper or the multi-site vendor scrapers on Apify Store.
What information does each couple record include?	Each record returns partner names, wedding date, location (city and state when available), the couple's WeddingWire website URL, and their welcome message when details fetching is enabled.
How does discover mode find couples without a name?	WeddingWire assigns sequential numeric IDs to couple websites. Discover mode walks those IDs downward from a starting point, reading each public profile and applying your filters, so it finds couples you would not know to search for by name.
Can I filter couples by location?	Yes, in discover mode you can set a US state filter using the full state name or the two-letter postal code. Couples without a public location are skipped when this filter is active.
What is the randomized start option?	When discover mode runs without a fixed start website ID, randomized start picks a random point in the 42,000,000 to 46,000,000 ID band, which covers the freshest upcoming weddings. This means repeated runs return different couples instead of the same set.
How many couples can I collect in one run?	You set the maximum couples per run, up to one million. In discover mode you also set a scan budget (max IDs to walk), and the run stops when either limit is reached.
Does search mode return all matching couples for a name?	Search mode returns up to 20 public couples per search term, which is WeddingWire's directory display limit. For broader discovery without name constraints, use discover mode.
What happens when I enable 'Only complete leads'?	The Actor keeps only couples that have both a partner name and a wedding date. Sparse records are skipped and counted in the log, so you know how many were filtered out.
Is a WeddingWire login required?	No. This Actor reads only the public-facing couple directory and wedding websites, so no account, login, or API key is needed.
Can I export the data to Google Sheets?	Yes. You can export your dataset to CSV, JSON, Excel, or XML from Apify, and integrations can push the data directly to Google Sheets, Airtable, or your CRM.

Related actors

Browse the full ParseForge collection for more scrapers.

🆘 Need help? Email parseforge@protonmail.com with your run ID, your input, and what you expected.

⚠️ Disclaimer. This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by WeddingWire, Inc. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.