# WeddingWire Vendor Scraper(+Email) (`dionysus_way/weddingwire-vendor-scraper-email`) Actor Scrape WeddingWire.com vendor listings and profiles to extract names, locations, ratings, reviews, pricing, contact details (some emails), social links, services, and profile metadata for lead generation, research, and market analysis. - **URL**: https://apify.com/dionysus\_way/weddingwire-vendor-scraper-email.md - **Developed by:** [Dionysus](https://apify.com/dionysus_way) (community) - **Categories:** Lead generation, Other, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $5.30 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ### WeddingWire Vendor Scraper *(scrapes WeddingWire vendor category pages and full vendor profiles)* Examples: - https://www.weddingwire.com/c/ny-new-york/wedding-photographers/10-sca.html - https://www.weddingwire.com/c/co-colorado/wedding-caterers/18-sca.html - https://www.weddingwire.com/shared/search?group_id=2&category_id=18&state_id=6&city_id=12345 Extract **WeddingWire vendor** data to **JSON, CSV, Excel, or API output** for lead lists, research, CRM enrichment, and market analysis. #### What you get - **name** - vendor business name - **profileUrl** - vendor profile page - **sourceUrl** - listing URL where the vendor was found - **location** - vendor location - **rating** - vendor rating - **reviewCount** - review count - **price** - pricing text when available - **phone** - vendor phone number - **website** - website listed on WeddingWire when available - **websiteGuess** - best website match when WeddingWire does not list one - **websiteGuessConfidence** - confidence score for `websiteGuess` - **emailGuess** - public email found on the vendor website when available - **facebook, instagram, twitter, pinterest** - social links when available - **awards** - award text when available - **services** - service tags - **description** - vendor description - **address** - address text when available - **responseTime** - response speed text when available - **yearsInBusiness** - years in business text when available - **ownerName** - owner or rep name when available - **travelRange** - travel range text when available - **extractedAt** - scrape timestamp #### Example input ```json { "startUrls": [ "https://www.weddingwire.com/c/ny-new-york/wedding-photographers/10-sca.html" ], "maxVendorsPerCategory": 50, "maxPagesPerCategory": 5 } ```` #### Example output ```json { "name": "MALA Photography", "profileUrl": "https://www.weddingwire.com/biz/mala-photography/f7ebc8de7e8f54a2.html", "sourceUrl": "https://www.weddingwire.com/c/ny-new-york/wedding-photographers/10-sca.html", "location": "Orient, NY", "rating": 5, "reviewCount": 15, "price": "$6,000", "phone": "+16312911755", "websiteGuess": "https://www.marylatham.com/", "websiteGuessConfidence": 92, "emailGuess": "hello@marylatham.com", "instagram": "https://instagram.com/marylatham", "awards": [ "WeddingWire Couples' Choice Awards 2025 Winner" ], "services": [ "Additional Hours", "Destination / Travel", "Engagement Shoot" ], "address": "Orient, NY, 11957", "travelRange": "This vendor will travel up to no travel restrictions", "extractedAt": "2026-05-07T10:47:48.983Z" } ``` #### Input fields | Field | Type | Notes | |---|---|---| | `startUrls` | array (1-3) required | 1 to 3 WeddingWire listing URLs | | `maxVendorsPerCategory` | integer | Max vendors per listing URL. `0` = no cap | | `maxPagesPerCategory` | integer | Max listing pages per URL. `0` = no cap | #### Key features - Scrapes **listing pages and full vendor profiles** - Works with WeddingWire category pages and faceted search URLs - Supports up to **3 listing URLs** in one run - Tries to find a real vendor website when WeddingWire does not list one - Tries to find a public email on the vendor website when available - Lets you cap vendors and pages to keep runs smaller - Deduplicates and resumes interrupted runs #### Typical use cases - Building **wedding vendor lead lists** by city or category - **Market research** across local wedding markets - **CRM enrichment** with vendor profile data - **Competitive analysis** of pricing, reviews, and services - **Trend tracking** for awards and profile changes #### Quick start 1. Paste **1 to 3 WeddingWire listing URLs** into `startUrls` 2. Set `maxVendorsPerCategory` and `maxPagesPerCategory` if you want caps 3. Run the Actor 4. Download the dataset as JSON, CSV, Excel, or use it through API #### FAQ **Does this Actor scrape only listing cards?**\ No. It scrapes listing pages and full vendor profile pages. **Why do some fields end with `Guess`?**\ Those fields come from public web search or the vendor's own website, not directly from WeddingWire. **Can I use multiple listing URLs in one run?**\ Yes. Add up to 3 listing URLs. **Will every vendor have website, email, awards, and services?**\ No. Some profiles do not expose every field. **What kind of URLs should I use?**\ Use WeddingWire listing URLs, not vendor profile URLs. # Actor input Schema ## `startUrls` (type: `array`): Paste one or more WeddingWire vendor listing pages (for example, wedding photographers in New York). You can add up to 3 URLs and the scraper will go through each one. ## `maxVendorsPerCategory` (type: `integer`): Stop after collecting this many vendors from each listing URL. Set to 0 to collect every vendor the listing has. Lower numbers run faster and cost less — useful when you just want a sample. ## `maxPagesPerCategory` (type: `integer`): Stop after this many listing pages per URL. Set to 0 to go through all pages. Each listing page has about 30 vendors. Use this to cap how deep the scraper goes. ## Actor input object example ```json { "startUrls": [ "https://www.weddingwire.com/shared/search?id_grupo=1&id_sector=1&id_region=402&id_provincia=10092&id_poblacion=&id_geozona=&geoloc=&latitude=&longitude=&isBrowseByImagesEnabled=&keyword=&faqs%5B%5D=&capacityRange%5B%5D=&txtStrSearch=Mansion+Weddings&txtLocSearch=Tucson" ], "maxVendorsPerCategory": 0, "maxPagesPerCategory": 0 } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrls": [ "https://www.weddingwire.com/shared/search?id_grupo=1&id_sector=1&id_region=402&id_provincia=10092&id_poblacion=&id_geozona=&geoloc=&latitude=&longitude=&isBrowseByImagesEnabled=&keyword=&faqs%5B%5D=&capacityRange%5B%5D=&txtStrSearch=Mansion+Weddings&txtLocSearch=Tucson" ] }; // Run the Actor and wait for it to finish const run = await client.actor("dionysus_way/weddingwire-vendor-scraper-email").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrls": ["https://www.weddingwire.com/shared/search?id_grupo=1&id_sector=1&id_region=402&id_provincia=10092&id_poblacion=&id_geozona=&geoloc=&latitude=&longitude=&isBrowseByImagesEnabled=&keyword=&faqs%5B%5D=&capacityRange%5B%5D=&txtStrSearch=Mansion+Weddings&txtLocSearch=Tucson"] } # Run the Actor and wait for it to finish run = client.actor("dionysus_way/weddingwire-vendor-scraper-email").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrls": [ "https://www.weddingwire.com/shared/search?id_grupo=1&id_sector=1&id_region=402&id_provincia=10092&id_poblacion=&id_geozona=&geoloc=&latitude=&longitude=&isBrowseByImagesEnabled=&keyword=&faqs%5B%5D=&capacityRange%5B%5D=&txtStrSearch=Mansion+Weddings&txtLocSearch=Tucson" ] }' | apify call dionysus_way/weddingwire-vendor-scraper-email --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=dionysus_way/weddingwire-vendor-scraper-email", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "WeddingWire Vendor Scraper(+Email)", "description": "Scrape WeddingWire.com vendor listings and profiles to extract names, locations, ratings, reviews, pricing, contact details (some emails), social links, services, and profile metadata for lead generation, research, and market analysis.", "version": "0.1", "x-build-id": "7tg6lYhgZECZ5yFDh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dionysus_way~weddingwire-vendor-scraper-email/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dionysus_way-weddingwire-vendor-scraper-email", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/dionysus_way~weddingwire-vendor-scraper-email/runs": { "post": { "operationId": "runs-sync-dionysus_way-weddingwire-vendor-scraper-email", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/dionysus_way~weddingwire-vendor-scraper-email/run-sync": { "post": { "operationId": "run-sync-dionysus_way-weddingwire-vendor-scraper-email", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "startUrls" ], "properties": { "startUrls": { "title": "WeddingWire listing URLs", "minItems": 1, "maxItems": 3, "type": "array", "description": "Paste one or more WeddingWire vendor listing pages (for example, wedding photographers in New York). You can add up to 3 URLs and the scraper will go through each one.", "items": { "type": "string", "pattern": "^https?://(?:www\\.)?weddingwire\\.com/.+$" } }, "maxVendorsPerCategory": { "title": "Max vendors per listing", "minimum": 0, "type": "integer", "description": "Stop after collecting this many vendors from each listing URL. Set to 0 to collect every vendor the listing has. Lower numbers run faster and cost less — useful when you just want a sample.", "default": 0 }, "maxPagesPerCategory": { "title": "Max pages per listing", "minimum": 0, "type": "integer", "description": "Stop after this many listing pages per URL. Set to 0 to go through all pages. Each listing page has about 30 vendors. Use this to cap how deep the scraper goes.", "default": 0 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```