ParseForge Scrapers

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.

Run this scraper See the API call
Total users
9
Monthly active
2
Total runs
147
Bookmarked
0
Rating
Not rated yet
Last modified
12 days ago

Overview

ParseForge

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

  1. Create a free Apify account with $5 in credit.
  2. Open the The Knot Wedding Vendor 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 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

FieldTypeWhat it doesDefault
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 forWhat it isPrice 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.

POST ยท run and get results
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.

input.json
{
  "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.

Related scrapers

Run The Knot Wedding Vendor Scraper on Apify All scrapers