The Knot Wedding Vendor Scraper
parseforge/theknot-scraper
Lead generationE-commerceBusiness
Scrapes wedding vendor listings from The Knot marketplace. Collects name, rating, review count, price range, and category. Optionally enriches with phone, email, website, and social links from vendor profiles.
- Total users
- 9
- Monthly active
- 2
- Total runs
- 147
- Bookmarked
- 0
- Rating
- Not rated yet
- Last modified
- 12 days ago
Overview
The Knot Wedding Vendor Scraper
Scrape wedding vendor listings from The Knot marketplace by category, city, or direct URL, up to a million per run. Every vendor comes with its rating, review count, price range, and contact details when profile enrichment is on. No login or API key. Export to CSV, JSON, Excel, or XML.
The Knot's wedding vendor marketplace is the largest in the US, but manually copying photographer, venue, or florist details from dozens of pages is slow and error-prone. This scraper reads the public vendor directory directly, filtering by category and location, and returns each match in one consistent schema. You can collect listing summaries for speed, or enable profile enrichment to pull phone numbers, emails, websites, and social links from each vendor's full profile.
| Who uses it | What they scrape The Knot for |
|---|---|
| Wedding planners | Build a local vendor shortlist with ratings and contact info for a client's city. |
| Marketing agencies | Generate lead lists of wedding photographers, DJs, or florists for outreach campaigns. |
| Venue owners | Research competing reception venues in a metro area by price range and review count. |
| Data analysts | Track vendor availability and pricing trends across US wedding markets. |
What it does
This Actor collects wedding vendor listings from The Knot marketplace by category, city, or direct URL, and returns each vendor as a flat row.
- ๐ Direct URLs: paste any The Knot marketplace category page or individual vendor profile URL.
- ๐๏ธ Structured search: pick a vendor category, city, and state code, and the actor builds the URL and paginates through all results.
- ๐ Sort control: order listings by recommended, featured, popular, newest, or highest rated.
- ๐ Profile enrichment: optionally visit each vendor's profile to extract phone, email, website, social links, full description, and award history.
Results export to CSV, JSON, Excel, or XML, or straight from the API.
What you can do with The Knot data
๐ Build a local vendor shortlist.
A wedding planner picks 'Wedding Photographers' and 'new-york' plus 'ny' to collect every listed photographer with ratings and price ranges for a client.
๐ง Generate a lead list for outreach.
A marketing agency enables profile enrichment and scrapes DJs in Miami to get email addresses and websites for a cold email campaign.
๐จ Research competing venues.
A venue owner scrapes 'Reception Venues' in Austin, TX, sorted by highest rated, to compare pricing and review counts against their own property.
๐ Track vendor availability by market.
A data analyst runs the scraper weekly across five metro areas to monitor how many florists and caterers are listed in each city over time.
Why choose this scraper
| What you get | |
|---|---|
| No API registration | Reads the public marketplace pages directly with no OAuth or app setup. |
| Fixed output schema | Every vendor row has the same fields, whether from a listing page or an enriched profile. |
| Category and location aware | Builds the correct /marketplace/{category}-{city}-{state} URL from dropdowns. |
| Contact details on demand | Profile enrichment adds phone, email, website, and social links when you need them. |
How it compares
This actor and the existing The Knot Marketplace Scraper both extract vendor data from The Knot, but they differ in input flexibility and enrichment control.
| Feature | ParseForge | The Knot Marketplace Scraper - Wedding Vendor Leads |
|---|---|---|
| Structured category and location search | Yes, dropdowns for category, city, and state | Not listed |
| Profile enrichment for contact details | Yes, optional toggle | Yes |
| Sort order control | Yes, five sort options | Not listed |
| Scrape up to 1,000,000 vendors per run | Yes | Not listed |
| Direct vendor profile URL input | Yes | Not listed |
Configure the run
Drive the Actor from marketplace URLs, or a structured category plus city and state combination, and set a maximum vendor count to cap the run. The Input tab lists every parameter.
A first run with the defaults:
{
"startUrls": [
"https://www.theknot.com/marketplace/wedding-photographers-new-york-ny"
],
"maxItems": 10
}
A larger pull:
{
"startUrls": [
"https://www.theknot.com/marketplace/wedding-photographers-new-york-ny"
],
"maxItems": 200
}
Pricing
Pay-per-result: $0.02 per result collected. You pay only for the results written to your dataset.
| Results collected | Approximate cost |
|---|---|
| 100 results | $2.00 |
| 1,000 results | $20.00 |
| 10,000 results | $200.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
- Create a free Apify account with $5 in credit.
- Open the The Knot Wedding Vendor Scraper.
- Set your inputs and any filters, then click Start.
- 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 The Knot 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/theknot-scraper"
Then prompt it in plain language to run the scraper and read back the results.
Troubleshooting
Why am I getting no results?
Check that your city name uses lowercase and hyphens (e.g. 'new-york', not 'New York'). Also verify the two-letter state code matches the city. If using direct URLs, make sure the URL points to a valid The Knot marketplace category or vendor profile page.
The scraper is running very slowly.
Profile enrichment adds one request per vendor, which slows the run. If speed is more important than contact details, disable the 'Enrich with vendor profile pages' option to collect listing-level data only.
Some vendors are missing phone numbers or emails even with enrichment on.
Not every vendor publishes contact details on their The Knot profile. The scraper extracts whatever is publicly available. If a field is blank, the vendor likely did not provide that information.
I get an error when using structured search without a city.
The structured search requires both a category and a city plus state code. If you leave the city or state empty, the actor cannot build a valid URL. Either fill in all three fields or use the Marketplace URLs input instead.
The actor stopped before collecting all vendors.
Check the 'Maximum vendors' setting. The actor stops when it hits that number. Increase the limit if you want more results, up to 1,000,000.
FAQ
| Question | Answer |
|---|---|
| Can I scrape multiple cities in one run? | Yes. Paste multiple marketplace URLs into the startUrls field, each with a different city and category combination, and the actor will process them sequentially. |
| Does the scraper get phone numbers and emails? | It can. Enable the 'Enrich with vendor profile pages' option, and the actor will visit each vendor's profile to extract phone, email, website, and social links. Without enrichment, you get listing-level data only. |
| What is the difference between listing mode and profile enrichment? | Listing mode collects data from the search results page: name, rating, review count, price range, and category. Profile enrichment visits each vendor's individual page to add contact details, full description, awards, and social links. Enrichment is slower because it makes one extra request per vendor. |
| How do I scrape a specific vendor category? | Use the structured search section. Pick a category from the dropdown, enter a city and two-letter state code, and leave the Marketplace URLs field empty. The actor builds the correct URL and paginates through all results. |
| Can I scrape individual vendor profiles directly? | Yes. Paste one or more vendor profile URLs into the Marketplace URLs field, and the actor will collect each vendor's full details. |
| What sort orders are available? | You can sort marketplace listings by Recommended, Featured, Popular, Newest, or Highest Rated. The default is Recommended, which uses The Knot's personalised scoring. |
| Is there a limit on how many vendors I can scrape? | You set the maximum with the 'Maximum vendors' field, up to 1,000,000 per run. The actor stops when it reaches that count or exhausts the listings. |
| What export formats are supported? | The dataset can be exported to CSV, JSON, Excel, or XML from the Apify platform. |
| Does this scraper work for locations outside the US? | The structured search is built for US states and cities. For international locations, you would need to paste the direct marketplace URL into the startUrls field if The Knot supports that region. |
| Do I need a The Knot account to scrape? | No. The scraper reads the public vendor directory pages and does not require a login, API key, or account registration. |
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 The Knot Worldwide 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.
Input
| Field | Type | What it does | Default |
|---|---|---|---|
| startUrls | array | One or more The Knot marketplace URLs. Paste a category + city URL (e.g. https://www.theknot.com/marketplace/wedding-photographers-new-york-ny) or a vendor profile URL. Leave empty to use the structured Category + Location inputs below. | ["https://www.theknot.com/marketplace/we |
| maxItems | integer | Maximum number of vendors to collect per run. | 10 |
| category | string (26 options) | Pick a vendor category. Used together with City + State to build the marketplace URL when Marketplace URLs is empty. | not set |
| city | string | Lowercase, hyphen-separated city name (e.g. new-york, los-angeles, chicago, miami, austin). | not set |
| stateCode | string (52 options) | Two-letter US state abbreviation: ny, ca, tx, fl, il, etc. | not set |
| sort | string (5 options) | How the marketplace orders listings. Default is recommended (The Knot's personalised score). Featured promotes paid vendors first. | recommended |
| includeDetails | boolean | When enabled, the scraper visits each vendor's profile page to pull phone, email, website, social links, full description, and award history. Slower (one extra request per vendor) but much richer output. | false |
Pricing
from $15.00 per 1,000 results
| Charged for | What it is | Price each |
|---|---|---|
| Actor Start | Charged once when the run starts. | $0.005 |
| Wedding Vendor Record | One scraped vendor with name, ratings, pricing, awards, services, and (optionally) contact info. | $0.015 to $0.02 |
Tiered: the lower figure is the price on a higher Apify plan. Billing and the free credit live on Apify.
API
One POST returns the dataset directly. Same shape for every scraper in the library, so swapping the slug is the only change.
curl -X POST "https://api.apify.com/v2/acts/parseforge~theknot-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"helloWorld": 123
}' Examples
Input that runs as-is.
{
"helloWorld": 123
} Reviews
No reviews yet. Be the first.
Issues
We build and maintain this scraper, so a problem with it comes to us. Report it on the Apify listing and the thread stays attached to the scraper where the next person can find it: open an issue.
Broken and urgent, or you would rather not post in public? Write to parseforge@protonmail.com and it reaches the people who wrote it.
