The Knot Marketplace Scraper

The Knot Marketplace Scraper pulls wedding vendor data from TheKnot.com listing pages. Give it a category slug like wedding-photographers and a location like new-york-ny, and it returns each vendor's name, service area, star rating, review count, price tier, portfolio photos, and business bio across all result pages. Works with direct search URLs too, one or many.

Useful for building sales prospect lists, populating a CRM with local vendor contacts, or tracking which businesses show up in a given market.

---

What it collects

Each vendor record includes:

• Vendor name
• Profile URL on TheKnot.com
• Service location (city and region as listed)
• Star rating and review count
• Price range (e.g. $$ - Affordable, $$$$ - Luxury)
• Business bio excerpt visible on the listing card
• Portfolio image URLs (up to 5)
• Awards (e.g. Award winner (2x), Best of Weddings)
• Vendor badges (e.g. Responds quickly)
• Category name inferred from the search URL
• Source listing page URL and page number
• Timestamp of when the record was collected

---

Input

You can either provide listing URLs directly, or let the actor build the URL from a category and location.

Option A: Start URLs

Paste one or more TheKnot.com marketplace listing URLs:

{
  "startUrls": [
    "https://www.theknot.com/marketplace/wedding-photographers-new-york-ny",
    "https://www.theknot.com/marketplace/florists-los-angeles-ca"
  ]
}

Option B: Category and location slugs

{
  "category": "wedding-djs",
  "location": "chicago-il"
}

The actor builds https://www.theknot.com/marketplace/wedding-djs-chicago-il from these two fields.

All input fields

Field	Type	Default	Description
startUrls	string list	—	One or more TheKnot.com marketplace listing URLs
category	string	—	Category slug, e.g. wedding-photographers
location	string	—	City-state slug, e.g. new-york-ny
maxPages	integer	3	Pages of results to collect per URL (each page is ~30 vendors)
maxItems	integer	100	Total vendor records cap across all URLs
requestTimeoutSecs	integer	60	Per-page timeout in seconds

---

Category slugs

Some common categories on TheKnot.com:

Category	Slug
Wedding Photographers	wedding-photographers
Videographers	wedding-videographers
Florists	florists
Wedding DJs	wedding-djs
Wedding Bands	live-wedding-bands
Photo Booths	wedding-photo-booth-rentals
Wedding Planners	wedding-planners
Catering	catering
Wedding Cakes	wedding-cake-bakeries
Reception Venues	wedding-reception-venues
Transportation	transportation-services

Location slugs follow the pattern {city}-{state-code}, for example san-diego-ca, austin-tx, miami-fl.

---

Example output

{
  "vendorId": "373c48de-ff47-49a0-9ba4-3109eabcd795",
  "vendorName": "The Capture Corner",
  "vendorUrl": "https://www.theknot.com/marketplace/the-capture-corner-san-diego-ca-2088163",
  "location": "San Diego and all of SoCal",
  "rating": 5.0,
  "reviewCount": 79,
  "priceRange": "$$ - Affordable",
  "shortDescription": "Since 2018, we've helped couples across Southern California celebrate in style, capturing joyful moments and creating keepsakes your guests will love.",
  "imageUrls": [
    "https://media-api.xogrp.com/images/3c591157-272e-4c92-94b1-1b0f73804c01~sc_310.210?quality=70",
    "https://media-api.xogrp.com/images/44be28a5-c691-40bd-a379-5ce74b3d2b4b~sc_310.210?quality=70"
  ],
  "awards": ["Award winner (2x)"],
  "isBestOfWeddings": true,
  "badgeTexts": ["Responds quickly"],
  "categoryName": "Wedding Photo Booth Rentals",
  "pageUrl": "https://www.theknot.com/marketplace/wedding-photo-booth-rentals-san-diego-ca",
  "pageNumber": 1,
  "scrapedAt": "2026-05-12T10:30:00.000Z"
}

---

Usage tips

Scraping a full market: Set maxPages to 20 and maxItems to 1000 to collect every vendor in a category and location. Most markets have 1-5 pages of results (30 vendors per page).

Multi-city runs: Add multiple URLs to startUrls, one per city. The actor processes them in order and stops when it hits maxItems.

CRM import: The output fields map cleanly to contact records. vendorName and vendorUrl give you the lead identity, location gives geography, rating and reviewCount help prioritize outreach.

Filtering by awards: The isBestOfWeddings boolean flags vendors with award recognition. Use it to filter the dataset to top-rated vendors only.

---

Limitations

• TheKnot.com listing pages show the business bio as a short excerpt. Full descriptions are on the individual vendor profile pages.
• Phone numbers, email addresses, and website links are on individual vendor profile pages, not the listing cards.
• Results reflect what is publicly listed on TheKnot.com at the time of the run. Vendor data changes as businesses update their profiles.

---

Legal notice

This actor collects publicly visible data from TheKnot.com listing pages. Use it in line with TheKnot.com's terms of service and applicable data regulations. Do not use collected data for spam or unsolicited bulk outreach.