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

GET /api/v1/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 type: `estate`, `villa`, `ranch`, `cabin`, `castle`, `compound`
`capacity_min`	number	Minimum sleeping capacity
`capacity_max`	number	Maximum sleeping capacity
`price_min`	number	Minimum price per night (USD)
`price_max`	number	Maximum price per night (USD)
`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: 50)
`cursor`	string	Cursor for pagination (from `pagination.next_cursor`)

Example request

curl -X GET "https://www.thewedstay.com/api/v1/venues?state=texas&capacity_min=20&amenities=pool,outdoor-ceremony" \
  -H "Authorization: Bearer ws_live_..."

Example response

{
  "data": [
    {
      "slug": "texas-wedding-village",
      "name": "Texas Wedding Village",
      "city": "Canyon Lake",
      "state": "Texas",
      "venue_type": "compound",
      "capacity_min": 50,
      "capacity_max": 300,
      "bedrooms": 14,
      "price_range": "$3,500 - $5,500/night",
      "hero_image": "https://www.thewedstay.com/cdn-images/property-photos/.../exterior-medium.webp",
      "seo_description": "A 14-cabin wedding village with pool and event spaces.",
      "amenities": ["pool", "outdoor-ceremony", "cabins", "event-hall"],
      "url": "https://www.thewedstay.com/properties/texas/canyon-lake/texas-wedding-village-..."
    }
  ],
  "pagination": {
    "has_more": false,
    "next_cursor": null,
    "total_count": 8
  },
  "request_id": "req_abc123def456"
}

Get venue details

GET /api/v1/venues/:slug

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 URL slug

Example request

curl -X GET "https://www.thewedstay.com/api/v1/venues/texas-wedding-village" \
  -H "Authorization: Bearer ws_live_..."

Example response

{
  "data": {
    "slug": "texas-wedding-village",
    "name": "Texas Wedding Village",
    "city": "Canyon Lake",
    "state": "Texas",
    "country": "US",
    "venue_type": "compound",
    "description": "A 14-cabin wedding village with pool, event spaces for 300 guests, and full venue buyout.",
    "seo_description": "A 14-cabin wedding village with pool and event spaces.",
    "capacity_min": 50,
    "capacity_max": 300,
    "bedrooms": 14,
    "bathrooms": 16,
    "accommodates": 84,
    "price_range": "$3,500 - $5,500/night",
    "amenities": ["pool", "outdoor-ceremony", "cabins", "event-hall", "commercial-kitchen", "fire-pit"],
    "categories": ["compound"],
    "hero_image": "https://www.thewedstay.com/cdn-images/property-photos/.../exterior-medium.webp",
    "photos": [
      {
        "url": "https://www.thewedstay.com/cdn-images/property-photos/.../exterior-medium.webp",
        "category": "exterior",
        "is_featured": true,
        "position": 1
      },
      {
        "url": "https://www.thewedstay.com/cdn-images/property-photos/.../interior-medium.webp",
        "category": "interior",
        "is_featured": false,
        "position": 2
      }
    ],
    "total_photos": 32,
    "testimonials": [
      {
        "guest_name": "Sarah & Mike",
        "rating": 5,
        "review": "The most incredible wedding weekend experience.",
        "event_date": "2025-10-15"
      }
    ],
    "url": "https://www.thewedstay.com/properties/texas/texas-wedding-village"
  },
  "request_id": "req_abc123def456"
}

Notes

Photos are capped at 3 preview images. The total_photos field shows how many photos are available on the venue's full page. Visit the url to see the complete gallery.
Price ranges show approximate nightly rates rather than exact figures. Contact the venue through the inquiry endpoint for a precise quote.
The venue detail endpoint has its own rate limit (20/day) separate from the global daily limit.

Venue Endpoints

Search and retrieve data from wedding venues across the US, Mexico, Italy, Costa Rica, and Ireland.

Search venues

GET /api/v1/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 type: `estate`, `villa`, `ranch`, `cabin`, `castle`, `compound`
`capacity_min`	number	Minimum sleeping capacity
`capacity_max`	number	Maximum sleeping capacity
`price_min`	number	Minimum price per night (USD)
`price_max`	number	Maximum price per night (USD)
`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: 50)
`cursor`	string	Cursor for pagination (from `pagination.next_cursor`)

Example request

curl -X GET "https://www.thewedstay.com/api/v1/venues?state=texas&capacity_min=20&amenities=pool,outdoor-ceremony" \
  -H "Authorization: Bearer ws_live_..."

Example response

{
  "data": [
    {
      "slug": "texas-wedding-village",
      "name": "Texas Wedding Village",
      "city": "Canyon Lake",
      "state": "Texas",
      "venue_type": "compound",
      "capacity_min": 50,
      "capacity_max": 300,
      "bedrooms": 14,
      "price_range": "$3,500 - $5,500/night",
      "hero_image": "https://www.thewedstay.com/cdn-images/property-photos/.../exterior-medium.webp",
      "seo_description": "A 14-cabin wedding village with pool and event spaces.",
      "amenities": ["pool", "outdoor-ceremony", "cabins", "event-hall"],
      "url": "https://www.thewedstay.com/properties/texas/canyon-lake/texas-wedding-village-..."
    }
  ],
  "pagination": {
    "has_more": false,
    "next_cursor": null,
    "total_count": 8
  },
  "request_id": "req_abc123def456"
}

Get venue details

GET /api/v1/venues/:slug

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 URL slug

Example request

curl -X GET "https://www.thewedstay.com/api/v1/venues/texas-wedding-village" \
  -H "Authorization: Bearer ws_live_..."

Example response

{
  "data": {
    "slug": "texas-wedding-village",
    "name": "Texas Wedding Village",
    "city": "Canyon Lake",
    "state": "Texas",
    "country": "US",
    "venue_type": "compound",
    "description": "A 14-cabin wedding village with pool, event spaces for 300 guests, and full venue buyout.",
    "seo_description": "A 14-cabin wedding village with pool and event spaces.",
    "capacity_min": 50,
    "capacity_max": 300,
    "bedrooms": 14,
    "bathrooms": 16,
    "accommodates": 84,
    "price_range": "$3,500 - $5,500/night",
    "amenities": ["pool", "outdoor-ceremony", "cabins", "event-hall", "commercial-kitchen", "fire-pit"],
    "categories": ["compound"],
    "hero_image": "https://www.thewedstay.com/cdn-images/property-photos/.../exterior-medium.webp",
    "photos": [
      {
        "url": "https://www.thewedstay.com/cdn-images/property-photos/.../exterior-medium.webp",
        "category": "exterior",
        "is_featured": true,
        "position": 1
      },
      {
        "url": "https://www.thewedstay.com/cdn-images/property-photos/.../interior-medium.webp",
        "category": "interior",
        "is_featured": false,
        "position": 2
      }
    ],
    "total_photos": 32,
    "testimonials": [
      {
        "guest_name": "Sarah & Mike",
        "rating": 5,
        "review": "The most incredible wedding weekend experience.",
        "event_date": "2025-10-15"
      }
    ],
    "url": "https://www.thewedstay.com/properties/texas/texas-wedding-village"
  },
  "request_id": "req_abc123def456"
}

Notes

Photos are capped at 3 preview images. The total_photos field shows how many photos are available on the venue's full page. Visit the url to see the complete gallery.
Price ranges show approximate nightly rates rather than exact figures. Contact the venue through the inquiry endpoint for a precise quote.
The venue detail endpoint has its own rate limit (20/day) separate from the global daily limit.

Venues

Venue Endpoints

Search venues

Query parameters

Example request

Example response

Get venue details

Path parameters

Example request

Example response

Notes

On this page

Venues

Venue Endpoints

Search venues

Query parameters

Example request

Example response

Get venue details

Path parameters

Example request

Example response

Notes

On this page