The Knot Wedding Vendor Scraper

Web Scraping

This actor extracts data from websites. It handles JavaScript rendering, pagination, and anti-bot measures automatically.

Note: Always respect the website's terms of service and robots.txt.

---

Web Scraping

This actor extracts data from websites. It handles JavaScript rendering, pagination, and anti-bot measures automatically.

Note: Always respect the website's terms of service and robots.txt.

---

Scrape wedding vendor listings from The Knot - photographers, venues, caterers, florists, DJs, and more with reviews, pricing, and contact info.

Features

18 Vendor Categories

Category	Description
wedding-photographers	Wedding and engagement photography
wedding-venues	Ceremony and reception venues
wedding-videographers	Wedding films and cinematography
wedding-florists	Floral design and arrangements
wedding-caterers	Food and beverage service
wedding-djs	Music and entertainment
wedding-bands	Live bands and musicians
wedding-planners	Full and partial planning services
wedding-cakes	Cakes and desserts
bridal-salons	Wedding dresses and bridal wear
wedding-hair-makeup	Beauty services
wedding-invitations	Stationery and invitations
wedding-rentals	Tables, chairs, linens
wedding-transportation	Limos, shuttles, vintage cars
wedding-officiants	Ministers, officiants, celebrants
wedding-jewelers	Rings and jewelry
photo-booths	Photo booth rentals
wedding-decor	Decor and lighting

Complete Vendor Profiles

Each vendor includes:

• Business name and description
• Full address and location
• Phone, email, and website
• Average rating and review count
• Price range ($ to $$$$)
• Services offered
• Awards (Best of Weddings, Hall of Fame)
• Social media links
• Gallery images

Optional Review Scraping

Enable includeReviews: true to extract individual customer reviews with:

• Author name
• Rating (1-5 stars)
• Review date
• Wedding date
• Full review text
• Verified status

---

Quick Start

{
  "url": "https://example.com",
  "maxResults": 100
}

Demo Mode

Set demoMode: true to test with sample data (no charges). When you're ready for real results, set demoMode: false or omit it.

{
  "demoMode": true,
  ...
}

Input Parameters

Parameter	Type	Required	Description
location	string	Yes	City and state (e.g., "Austin, TX")
categories	array	No	Vendor categories to scrape
maxResults	integer	No	Max vendors per category (default: 50)
includeReviews	boolean	No	Scrape individual reviews
maxReviewsPerVendor	integer	No	Max reviews per vendor (default: 10)
demoMode	boolean	No	Use sample data (default: true)

---

Output Format

{
  "name": "Elegant Moments Photography",
  "category": "wedding-photographers",
  "subcategory": "Photography",
  "location": "Austin, TX",
  "city": "Austin",
  "state": "TX",
  "address": "123 Main St, Austin, TX 78701",
  "rating": 4.9,
  "reviewCount": 287,
  "priceRange": "$$$",
  "priceLevel": 3,
  "phone": "(512) 555-0123",
  "email": "info@elegantmoments.com",
  "website": "https://elegantmoments.com",
  "theKnotUrl": "https://www.theknot.com/marketplace/elegant-moments-photography-austin-tx",
  "description": "Award-winning wedding photography capturing your special moments...",
  "services": [
    "Engagement Sessions",
    "Full Day Coverage",
    "Second Photographer",
    "Drone Photography",
    "Photo Albums"
  ],
  "images": [
    "https://media-api.theknot.com/images/...",
    "https://media-api.theknot.com/images/..."
  ],
  "awards": [
    "The Knot Best of Weddings 2024",
    "The Knot Best of Weddings 2023"
  ],
  "reviews": [
    {
      "author": "Sarah M.",
      "rating": 5,
      "date": "2024-10-15",
      "title": "Absolutely Stunning Photos!",
      "text": "They captured every special moment perfectly...",
      "weddingDate": "2024-09-28",
      "verified": true
    }
  ],
  "socialMedia": {
    "instagram": "https://instagram.com/elegantmoments",
    "facebook": "https://facebook.com/elegantmoments",
    "pinterest": "https://pinterest.com/elegantmoments"
  },
  "scrapedAt": "2025-01-14T12:00:00.000Z"
}

---

Pricing

This actor uses pay-per-event billing:

• data_point: $0.01 per result

Use Cases

Wedding Planning Apps

Build a wedding vendor directory with real data. Let couples search, filter, and compare vendors by location, category, price, and rating.

Market Research

Analyze the wedding vendor market in any city:

• Average pricing by category
• Competition density
• Rating distributions
• Popular services

Lead Generation

Identify wedding vendors for B2B sales:

• Vendors without websites
• Low-rated vendors (opportunity for improvement services)
• New vendors without reviews
• Vendors missing social media presence

Competitive Analysis

Research competitors in your wedding vendor market:

• Compare pricing strategies
• Analyze service offerings
• Track awards and recognition
• Monitor customer feedback

---

---

Common Problems & Solutions

"Invalid API key" error

Cause: Your API key is wrong, expired, or doesn't have the right permissions. Fix: Double-check your API key. Make sure you copied it exactly without extra spaces.

"Rate limit exceeded" error

Cause: You've hit the API's rate limits. Fix: Wait a few minutes, then try again. Consider reducing the number of concurrent requests.

Empty or incomplete results

Cause: The target may have anti-scraping protection or the data doesn't exist. Fix:

• Check if the URL/search query is correct
• Try with different parameters
• Some sites may block automated access

Demo data showing instead of real results

Cause: demoMode is still set to true. Fix: Set demoMode: false and provide your API key(s).

---

Built by John Rippy | Actor Arsenal