Search wedding vendors across 12 categories including photography, catering, DJ, floral, and more.

Vendor Endpoints

Search and retrieve data from wedding vendors across 12 categories.

Search vendors

GET /api/v1/vendors

Search vendors with filters for category, location, and price range.

Query parameters

Parameter	Type	Description
`category`	string	Filter by category slug (see categories below)
`state`	string	Filter by state/region slug
`city`	string	Filter by city slug
`location`	string	Filter by location (state or city)
`price_min`	number	Minimum starting price (USD)
`price_max`	number	Maximum starting price (USD)
`search`	string	Free-text search across vendor names and bios
`featured`	boolean	Filter for featured vendors only
`sort_by`	string	Sort order: `newest`, `price_low_to_high`, `price_high_to_low`, `experience`, `weddings_completed`
`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/vendors?category=photography&state=california" \
  -H "Authorization: Bearer ws_live_..."

Example response

{
  "data": [
    {
      "slug": "golden-hour-studios",
      "business_name": "Golden Hour Studios",
      "service_category": "Photography",
      "primary_city": "Los Angeles",
      "primary_state": "California",
      "bio": "Documentary-style wedding photography specializing in outdoor and estate weddings.",
      "starting_price": 3500,
      "years_in_business": 8,
      "weddings_completed": 200,
      "service_areas": ["Los Angeles", "Orange County", "Santa Barbara"],
      "specialties": ["Outdoor weddings", "Estate weddings", "Documentary style"],
      "featured": true,
      "url": "https://www.thewedstay.com/vendors/photography/golden-hour-studios"
    }
  ],
  "pagination": {
    "has_more": false,
    "next_cursor": null,
    "total_count": 15
  },
  "request_id": "req_abc123def456"
}

GET /api/v1/vendors/categories

Returns all 12 vendor categories with counts.

Example response

{
  "data": [
    { "slug": "photography", "name": "Photography", "vendor_count": 28 },
    { "slug": "videography", "name": "Videography", "vendor_count": 22 },
    { "slug": "planning", "name": "Wedding Planning", "vendor_count": 18 },
    { "slug": "floral", "name": "Floral Design", "vendor_count": 24 },
    { "slug": "catering", "name": "Catering", "vendor_count": 20 },
    { "slug": "dj", "name": "DJ & Music", "vendor_count": 16 },
    { "slug": "hair-makeup", "name": "Hair & Makeup", "vendor_count": 19 },
    { "slug": "transportation", "name": "Transportation", "vendor_count": 8 },
    { "slug": "cake", "name": "Cake & Desserts", "vendor_count": 14 },
    { "slug": "lighting-decor", "name": "Lighting & Decor", "vendor_count": 12 },
    { "slug": "jewelry", "name": "Jewelry", "vendor_count": 6 },
    { "slug": "other", "name": "Other Services", "vendor_count": 13 }
  ],
  "request_id": "req_abc123def456"
}

Get vendor details

GET /api/v1/vendors/:slug

Retrieve full details for a single vendor.

Path parameters

Parameter	Type	Description
`slug`	string	The vendor's URL slug

Example request

curl -X GET "https://www.thewedstay.com/api/v1/vendors/golden-hour-studios" \
  -H "Authorization: Bearer ws_live_..."

Example response

{
  "data": {
    "slug": "golden-hour-studios",
    "business_name": "Golden Hour Studios",
    "service_category": "Photography",
    "primary_city": "Los Angeles",
    "primary_state": "California",
    "bio": "Documentary-style wedding photography specializing in outdoor and estate weddings.",
    "starting_price": 3500,
    "years_in_business": 8,
    "weddings_completed": 200,
    "service_areas": ["Los Angeles", "Orange County", "Santa Barbara"],
    "specialties": ["Outdoor weddings", "Estate weddings", "Documentary style"],
    "featured": true,
    "url": "https://www.thewedstay.com/vendors/photography/golden-hour-studios",
    "website": "https://goldenhourweddings.com",
    "instagram": "@goldenhourweddings",
    "portfolio_description": "We specialize in capturing candid, emotional moments.",
    "average_rating": 4.8,
    "review_count": 45
  },
  "request_id": "req_abc123def456"
}

Notes

Vendor detail includes website and instagram for direct contact. The search endpoint returns a leaner response without these fields.
To submit a lead through WedStay's pipeline, use POST /api/v1/inquiries/vendor.

Vendor Endpoints

Search and retrieve data from wedding vendors across 12 categories.

Search vendors

GET /api/v1/vendors

Search vendors with filters for category, location, and price range.

Query parameters

Parameter	Type	Description
`category`	string	Filter by category slug (see categories below)
`state`	string	Filter by state/region slug
`city`	string	Filter by city slug
`location`	string	Filter by location (state or city)
`price_min`	number	Minimum starting price (USD)
`price_max`	number	Maximum starting price (USD)
`search`	string	Free-text search across vendor names and bios
`featured`	boolean	Filter for featured vendors only
`sort_by`	string	Sort order: `newest`, `price_low_to_high`, `price_high_to_low`, `experience`, `weddings_completed`
`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/vendors?category=photography&state=california" \
  -H "Authorization: Bearer ws_live_..."

Example response

{
  "data": [
    {
      "slug": "golden-hour-studios",
      "business_name": "Golden Hour Studios",
      "service_category": "Photography",
      "primary_city": "Los Angeles",
      "primary_state": "California",
      "bio": "Documentary-style wedding photography specializing in outdoor and estate weddings.",
      "starting_price": 3500,
      "years_in_business": 8,
      "weddings_completed": 200,
      "service_areas": ["Los Angeles", "Orange County", "Santa Barbara"],
      "specialties": ["Outdoor weddings", "Estate weddings", "Documentary style"],
      "featured": true,
      "url": "https://www.thewedstay.com/vendors/photography/golden-hour-studios"
    }
  ],
  "pagination": {
    "has_more": false,
    "next_cursor": null,
    "total_count": 15
  },
  "request_id": "req_abc123def456"
}

GET /api/v1/vendors/categories

Returns all 12 vendor categories with counts.

Example response

{
  "data": [
    { "slug": "photography", "name": "Photography", "vendor_count": 28 },
    { "slug": "videography", "name": "Videography", "vendor_count": 22 },
    { "slug": "planning", "name": "Wedding Planning", "vendor_count": 18 },
    { "slug": "floral", "name": "Floral Design", "vendor_count": 24 },
    { "slug": "catering", "name": "Catering", "vendor_count": 20 },
    { "slug": "dj", "name": "DJ & Music", "vendor_count": 16 },
    { "slug": "hair-makeup", "name": "Hair & Makeup", "vendor_count": 19 },
    { "slug": "transportation", "name": "Transportation", "vendor_count": 8 },
    { "slug": "cake", "name": "Cake & Desserts", "vendor_count": 14 },
    { "slug": "lighting-decor", "name": "Lighting & Decor", "vendor_count": 12 },
    { "slug": "jewelry", "name": "Jewelry", "vendor_count": 6 },
    { "slug": "other", "name": "Other Services", "vendor_count": 13 }
  ],
  "request_id": "req_abc123def456"
}

Get vendor details

GET /api/v1/vendors/:slug

Retrieve full details for a single vendor.

Path parameters

Parameter	Type	Description
`slug`	string	The vendor's URL slug

Example request

curl -X GET "https://www.thewedstay.com/api/v1/vendors/golden-hour-studios" \
  -H "Authorization: Bearer ws_live_..."

Example response

{
  "data": {
    "slug": "golden-hour-studios",
    "business_name": "Golden Hour Studios",
    "service_category": "Photography",
    "primary_city": "Los Angeles",
    "primary_state": "California",
    "bio": "Documentary-style wedding photography specializing in outdoor and estate weddings.",
    "starting_price": 3500,
    "years_in_business": 8,
    "weddings_completed": 200,
    "service_areas": ["Los Angeles", "Orange County", "Santa Barbara"],
    "specialties": ["Outdoor weddings", "Estate weddings", "Documentary style"],
    "featured": true,
    "url": "https://www.thewedstay.com/vendors/photography/golden-hour-studios",
    "website": "https://goldenhourweddings.com",
    "instagram": "@goldenhourweddings",
    "portfolio_description": "We specialize in capturing candid, emotional moments.",
    "average_rating": 4.8,
    "review_count": 45
  },
  "request_id": "req_abc123def456"
}

Notes

Vendor detail includes website and instagram for direct contact. The search endpoint returns a leaner response without these fields.
To submit a lead through WedStay's pipeline, use POST /api/v1/inquiries/vendor.

Vendors

Vendor Endpoints

Search vendors

Query parameters

Example request

Example response

Example response

Get vendor details

Path parameters

Example request

Example response

Notes

On this page

Vendors

Vendor Endpoints

Search vendors

Query parameters

Example request

Example response

Example response

Get vendor details

Path parameters

Example request

Example response

Notes

On this page