Venues
Search, filter, and retrieve wedding venue data across multiple states and countries.
Venue Endpoints
Search and retrieve data from wedding venues across the US, Mexico, Italy, Costa Rica, and Ireland.
Search venues
Search venues with filters for location, capacity, price, venue type, and amenities.
Query parameters
| Parameter | Type | Description |
|---|---|---|
state | string | Filter by state/region slug (e.g. california, texas, tuscany) |
city | string | Filter by city slug (e.g. palm-springs, temecula) |
venue_type | string | Filter by property type (case-insensitive substring match): estate, villa, ranch, mansion, cabin, castle, chalet, lodge, cottage, barn, hacienda, farmhouse, chateau |
capacity_min | number | Minimum sleeping capacity |
capacity_max | number | Maximum sleeping capacity |
price_min | number | Minimum starting total for the minimum stay, in the venue's listed currency |
price_max | number | Maximum starting total for the minimum stay, in the venue's listed currency |
bedrooms_min | number | Minimum number of bedrooms |
amenities | string | Comma-separated list: pool, hot-tub, ocean-view, mountain-view, outdoor-ceremony, pet-friendly |
limit | number | Results per page (default: 20, max: 100). The MCP search_venues tool returns up to 50 per call |
cursor | string | Cursor for pagination (from pagination.next_cursor) |
price_min and price_max filter on pricing.starting_total.amount, the venue page's "starts at" figure for the minimum stay, compared in each venue's listed currency: euro venues compare in euros and Australian venues in Australian dollars. Venues with no listed price are left out of a price filtered search.
Example request
Example response
Get venue details
Retrieve full details for a single venue by its URL slug. Rate limited to 20 lookups per day on the free tier to prevent bulk scraping.
Path parameters
| Parameter | Type | Description |
|---|---|---|
slug | string | The venue's full slug from search results, URL encoded (each / as %2F) |
Example request
Example response
Notes
- Photos are capped at 5 preview images. They are absolute CDN URLs (medium-size WebP), in gallery order. The
total_photosfield shows how many photos are available on the venue's full page. Visit theurlto see the complete gallery. price_rangeis the base price for the whole minimum stay, not per night, before cleaning, service fee and tax, in the venue's listed currency (US dollars, euros for venues in euro countries, Australian dollars for Australian venues). Contact the venue through the inquiry endpoint for a precise quote.pricingis the same price as structured data, in the currency the venue page shows.weekday_baseandweekend_basecover the whole minimum stay;extra_nightis each night beyond it.starting_total.amountis exactly the venue page's "Your WedStay starts at" figure: the minimum stay at the weekday rate with cleaning, service fee and tax included (includes_fees). Euro prices are never converted; Australian prices are converted from the stored US dollar amount at the day's rate (rate_date) and rounded up to the nearest 100, as on the venue page. For any other dates or guest count, the MCPcalculate_pricingtool with the venue'sslugreturns the venue page calculator's total.- The venue detail endpoint has its own rate limit (20/day) separate from the global daily limit.