{
  "openapi": "3.0.1",
  "info": {
    "title": "Easy Weddings Australia Scraper",
    "description": "Scrape Australian wedding vendors from easyweddings.com.au - venues, photographers, caterers, florists, celebrants and 28 more categories across all 8 states/territories. Ratings, pricing, capacity, contact details, galleries and reviews.",
    "version": "1.0",
    "x-build-id": "GfaOHPqCHdoK2eRcQ"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/crawlerbros~easy-weddings-australia-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-crawlerbros-easy-weddings-australia-scraper",
        "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/crawlerbros~easy-weddings-australia-scraper/runs": {
      "post": {
        "operationId": "runs-sync-crawlerbros-easy-weddings-australia-scraper",
        "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/crawlerbros~easy-weddings-australia-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-crawlerbros-easy-weddings-australia-scraper",
        "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": [
          "mode"
        ],
        "properties": {
          "mode": {
            "title": "Mode",
            "enum": [
              "search",
              "vendorDetails"
            ],
            "type": "string",
            "description": "`search` browses all vendors in a category + region. `vendorDetails` fetches full profile detail (description, address, phone, gallery, reviews) for specific vendor URLs.",
            "default": "search"
          },
          "category": {
            "title": "Vendor category (mode=search)",
            "enum": [
              "WeddingVenues",
              "WeddingPhotography",
              "WeddingVideo",
              "WeddingCaterers",
              "WeddingCakes",
              "WeddingFlowers",
              "WeddingCars",
              "WeddingMusic",
              "WeddingDress",
              "DressDesigners",
              "FormalWear",
              "Bridesmaids",
              "FlowerGirls",
              "Lingerie",
              "WeddingShoes",
              "WeddingJewellery",
              "WeddingAccessories",
              "WeddingHair",
              "WeddingBeautyServices",
              "WeddingStylists",
              "WeddingDecorations",
              "WeddingInvitations",
              "Bomboniere",
              "WeddingHire",
              "MarriageCelebrant",
              "WeddingPlanner",
              "WeddingServices",
              "WeddingAccommodation",
              "EngagementVenues",
              "HensParty",
              "PhotoBooth",
              "Honeymoon"
            ],
            "type": "string",
            "description": "Wedding vendor category to browse.",
            "default": "WeddingVenues"
          },
          "location": {
            "title": "Region (mode=search)",
            "enum": [
              "Sydney",
              "CentralCoast",
              "Lismore",
              "HunterValley",
              "PortMacquarie",
              "CoffsHarbour",
              "Newcastle",
              "BlueMountains",
              "PortStephens",
              "CountryNSW",
              "SouthernHighlands",
              "Wagga",
              "AlburyWodonga",
              "Wollongong",
              "Melbourne",
              "WodongaAlbury",
              "Ballarat",
              "DandenongRanges",
              "Daylesford",
              "Geelong",
              "LakesEntrance",
              "Mornington",
              "Shepparton",
              "MurrayMildura",
              "YarraValley",
              "Brisbane",
              "Cairns",
              "GoldCoast",
              "CountryQLD",
              "Rockhampton",
              "SunshineCoast",
              "Townsville",
              "Whitsundays",
              "Adelaide",
              "CountrySA",
              "Perth",
              "Broome",
              "MargaretRiver",
              "Canberra",
              "Hobart",
              "Launceston",
              "Darwin"
            ],
            "type": "string",
            "description": "Australian region to browse. Covers all 8 states/territories.",
            "default": "Sydney"
          },
          "nameContains": {
            "title": "Vendor name contains (mode=search)",
            "type": "string",
            "description": "Case-insensitive substring match against the vendor's business name, e.g. 'garden' to find venues with 'garden' in the name.",
            "default": ""
          },
          "fiveStarOnly": {
            "title": "5-star rated only",
            "type": "boolean",
            "description": "Only include vendors with Easy Weddings' \"5-star\" badge.",
            "default": false
          },
          "exclusiveOfferOnly": {
            "title": "Exclusive offer only",
            "type": "boolean",
            "description": "Only include vendors currently advertising an exclusive Easy Weddings discount/offer.",
            "default": false
          },
          "minRating": {
            "title": "Minimum rating (0-5)",
            "minimum": 0,
            "maximum": 5,
            "type": "number",
            "description": "Drop vendors with an average review rating below this value.",
            "default": 0
          },
          "minReviewCount": {
            "title": "Minimum review count",
            "minimum": 0,
            "maximum": 100000,
            "type": "integer",
            "description": "Drop vendors with fewer reviews than this.",
            "default": 0
          },
          "minIndicativePrice": {
            "title": "Min indicative price (AUD)",
            "minimum": 0,
            "maximum": 1000000,
            "type": "integer",
            "description": "Drop vendors whose indicative price (per-head for venues/caterers, or average package price for other categories) is below this. Vendors with no price data always pass through."
          },
          "maxIndicativePrice": {
            "title": "Max indicative price (AUD)",
            "minimum": 0,
            "maximum": 1000000,
            "type": "integer",
            "description": "Drop vendors whose indicative price is above this. Vendors with no price data always pass through."
          },
          "minGuests": {
            "title": "Min guest capacity (venues)",
            "minimum": 0,
            "maximum": 5000,
            "type": "integer",
            "description": "Only for Wedding Venues category: keep venues whose maximum reception capacity is at least this many guests. Venues with no published capacity data always pass through."
          },
          "maxGuests": {
            "title": "Max guest requirement (venues)",
            "minimum": 0,
            "maximum": 5000,
            "type": "integer",
            "description": "Only for Wedding Venues category: keep venues whose minimum reception requirement is no more than this many guests (useful for small/intimate weddings). Venues with no published capacity data always pass through."
          },
          "ceremonyType": {
            "title": "Ceremony type (venues)",
            "enum": [
              "",
              "indoor",
              "outdoor"
            ],
            "type": "string",
            "description": "Only for Wedding Venues category: filter by ceremony setting.",
            "default": ""
          },
          "cateringType": {
            "title": "Catering type (venues)",
            "enum": [
              "",
              "inhouse",
              "thirdparty"
            ],
            "type": "string",
            "description": "Only for Wedding Venues category: filter by catering arrangement.",
            "default": ""
          },
          "styleTags": {
            "title": "Style tags (venues)",
            "type": "array",
            "description": "Only for Wedding Venues category: keep venues tagged with ANY of these styles.",
            "items": {
              "type": "string",
              "enum": [
                "garden",
                "affordable",
                "alternative",
                "beach",
                "ceremony",
                "country",
                "cultural",
                "external",
                "golfclub",
                "historic",
                "hotel",
                "luxury",
                "marquee",
                "micro",
                "modern",
                "museums",
                "restaurant",
                "rooftop",
                "small",
                "traditional",
                "unique",
                "warehouse",
                "waterview",
                "winery"
              ],
              "enumTitles": [
                "Garden",
                "Affordable",
                "Alternative",
                "Beach",
                "Ceremony-only",
                "Country",
                "Cultural",
                "Outdoor/external",
                "Golf club",
                "Historic",
                "Hotel",
                "Luxury",
                "Marquee",
                "Micro wedding",
                "Modern",
                "Museum",
                "Restaurant",
                "Rooftop",
                "Small wedding",
                "Traditional",
                "Unique",
                "Warehouse",
                "Waterview",
                "Winery"
              ]
            },
            "default": []
          },
          "sortBy": {
            "title": "Sort order (mode=search)",
            "enum": [
              "recommended",
              "reviews"
            ],
            "type": "string",
            "description": "Order in which matched vendors are emitted. `recommended` keeps Easy Weddings' own listing order; `reviews` orders by review count (descending), matching the site's \"Top Reviews\" sort.",
            "default": "recommended"
          },
          "vendorUrls": {
            "title": "Vendor profile URLs (mode=vendorDetails)",
            "type": "array",
            "description": "Full Easy Weddings vendor profile URLs, e.g. `https://www.easyweddings.com.au/WeddingVenues/Sydney/AtholHall/`.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "fetchFullProfile": {
            "title": "Enrich search results with full profile detail",
            "type": "boolean",
            "description": "mode=search only. When enabled, fetches each matched vendor's profile page too (description, full address, phone, gallery, reviews) — slower, one extra request per vendor.",
            "default": false
          },
          "maxItems": {
            "title": "Max items",
            "minimum": 1,
            "maximum": 500,
            "type": "integer",
            "description": "Hard cap on emitted records.",
            "default": 50
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}