TheKnot Wedding Vendor Scraper

Scrape wedding vendor listings from TheKnot.com marketplace. Extract comprehensive data including contact info, pricing, reviews, photos, and social links for photographers, venues, DJs, florists, and more.

Features

• Full pagination support - Scrape entire categories, not limited to a few URLs
• 18 vendor categories - Photographers, venues, DJs, florists, planners, caterers, etc.
• Complete contact data - Phone, email, website, social media links
• Pricing information - Starting prices and price ranges
• Reviews and ratings - Star ratings and review counts
• Media extraction - Photo URLs with dimensions
• Business details - Awards, service areas, owner bios

Input Configuration

Field	Type	Description
startUrls	array	TheKnot marketplace URLs to scrape
category	string	Vendor category (photographers, venues, etc.)
location	string	City/state in URL format (e.g., new-york-ny)
maxPages	integer	Max listing pages (30 vendors/page). 0 = unlimited
maxVendors	integer	Max total vendors. 0 = unlimited
scrapeDetails	boolean	Visit detail pages for full contact info
proxyConfiguration	object	Proxy settings

Example Input

{
    "category": "wedding-photographers",
    "location": "los-angeles-ca",
    "maxPages": 10,
    "maxVendors": 200,
    "scrapeDetails": true,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": ["RESIDENTIAL"]
    }
}

Output Data

Each vendor record includes:

{
    "name": "Studio Name",
    "phone": "(555) 123-4567",
    "email": "contact@studio.com",
    "website": "https://studio.com",
    "city": "New York",
    "state": "NY",
    "serviceArea": "Tri-State area",
    "startingPrice": "$5,000+",
    "rating": 5,
    "reviewCount": 150,
    "category": "Wedding Photographers",
    "facebookUrl": "https://facebook.com/...",
    "instagramUsername": "studiogram",
    "photos": [
        { "url": "https://...", "width": 1600, "height": 1067 }
    ],
    "awards": ["2024 Best of Weddings Winner", "Hall of Fame"],
    "ownerName": "Jane Doe",
    "ownerRole": "Lead Photographer",
    "profileUrl": "https://www.theknot.com/marketplace/..."
}

Available Categories

• wedding-photographers
• wedding-videographers
• wedding-reception-venues
• wedding-djs
• live-wedding-bands
• florists
• wedding-planners
• wedding-cake-bakeries
• catering
• beauty-services
• bridal-salons
• wedding-officiants
• wedding-photo-booth-rentals
• transportation-services
• bar-services
• wedding-decor-shops
• rehearsal-dinners-bridal-showers
• jewelers

Usage Tips

1. For bulk data: Set maxPages high and scrapeDetails: true for complete contact info
2. For speed: Set scrapeDetails: false to skip detail pages (less data but 10x faster)
3. Large cities: NYC, LA, Chicago have 300+ vendors per category
4. Proxies recommended: Use residential proxies to avoid rate limiting

Pricing

Uses pay-per-result pricing via Actor.charge():

• Charged per vendor scraped
• No charge for failed requests

Technical Notes

• Data source: window.__INITIAL_STATE__ JSON embedded in pages
• No heavy anti-bot protection when using proper browser headers
• 30 vendors per listing page
• Includes 500ms delay between detail page requests to avoid rate limiting