{
  "openapi": "3.0.1",
  "info": {
    "title": "Best Zillow Email Scraper",
    "description": "[𝗕𝟮𝗕 𝗘𝗠𝗔𝗜𝗟 𝗔𝗩𝗔𝗜𝗟𝗔𝗕𝗟𝗘] Boost your real estate outreach with the Zillow Email Scraper 📧. Find verified Zillow emails, agent contacts, and targeted leads fast. Perfect for marketers, agencies, and realtors who want high-quality Zillow leads in seconds. 🚀",
    "version": "1.0",
    "x-build-id": "n2EcZugxd9lgq56ko"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/scraper-mind~best-zillow-email-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-scraper-mind-best-zillow-email-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/scraper-mind~best-zillow-email-scraper/runs": {
      "post": {
        "operationId": "runs-sync-scraper-mind-best-zillow-email-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/scraper-mind~best-zillow-email-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-scraper-mind-best-zillow-email-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": [
          "keywords",
          "country",
          "scrapeFrom",
          "emailType",
          "maxEmails"
        ],
        "properties": {
          "keywords": {
            "title": "Keywords",
            "type": "array",
            "description": "Enter one or more keywords to search for on Zillow.",
            "items": {
              "type": "string"
            }
          },
          "country": {
            "title": "Country",
            "enum": [
              "United States",
              "United Kingdom",
              "Canada",
              "Australia",
              "Germany",
              "France",
              "India",
              "Japan",
              "Brazil",
              "Italy",
              "Spain",
              "Netherlands",
              "Sweden",
              "Norway",
              "Denmark",
              "Finland",
              "Poland",
              "Czech Republic",
              "Hungary",
              "Romania",
              "Bulgaria",
              "Croatia",
              "Slovenia",
              "Slovakia",
              "Estonia",
              "Latvia",
              "Lithuania",
              "Portugal",
              "Greece",
              "Cyprus",
              "Malta",
              "Luxembourg",
              "Ireland",
              "Belgium",
              "Austria",
              "Switzerland",
              "Liechtenstein",
              "Iceland",
              "South Korea",
              "China",
              "Mexico",
              "Argentina",
              "Chile",
              "Colombia",
              "Peru",
              "Venezuela",
              "Ecuador",
              "Uruguay",
              "Paraguay",
              "Bolivia",
              "Guyana",
              "Suriname",
              "French Guiana",
              "Falkland Islands (Malvinas)",
              "South Georgia and the South Sandwich Islands",
              "Bonaire, Sint Eustatius and Saba",
              "Curaçao",
              "Aruba",
              "Sint Maarten (Dutch part)",
              "Turks and Caicos Islands",
              "British Virgin Islands",
              "Anguilla",
              "Montserrat",
              "Antigua and Barbuda",
              "Barbados",
              "Dominica",
              "Grenada",
              "Saint Kitts and Nevis",
              "Saint Lucia",
              "Saint Vincent and the Grenadines",
              "Trinidad and Tobago",
              "Jamaica",
              "Bahamas",
              "Belize",
              "Costa Rica",
              "Guatemala",
              "Honduras",
              "Nicaragua",
              "Panama",
              "El Salvador",
              "Cuba",
              "Dominican Republic",
              "Haiti",
              "Puerto Rico",
              "U.S. Virgin Islands",
              "American Samoa",
              "Guam",
              "Northern Mariana Islands",
              "Saudi Arabia",
              "United Arab Emirates",
              "Bahrain",
              "Iraq",
              "Iran, Islamic Republic of",
              "Israel",
              "Jordan",
              "Kuwait",
              "Lebanon",
              "Oman",
              "Qatar",
              "Syrian Arab Republic",
              "Yemen",
              "Afghanistan",
              "Bangladesh",
              "Bhutan",
              "Maldives",
              "Nepal",
              "Pakistan",
              "Sri Lanka",
              "Myanmar",
              "Cambodia",
              "Lao People's Democratic Republic",
              "Thailand",
              "Viet Nam",
              "Malaysia",
              "Singapore",
              "Brunei Darussalam",
              "Philippines",
              "Indonesia",
              "Timor-Leste",
              "Papua New Guinea",
              "Fiji",
              "New Zealand",
              "Solomon Islands",
              "Vanuatu",
              "New Caledonia",
              "French Polynesia",
              "Wallis and Futuna",
              "Samoa",
              "Tonga",
              "Tuvalu",
              "Kiribati",
              "Nauru",
              "Federated States of Micronesia",
              "Marshall Islands",
              "Palau",
              "Cook Islands",
              "Niue",
              "Tokelau"
            ],
            "type": "string",
            "description": "Specify the country to target for Google search results.",
            "default": "United States"
          },
          "scrapeFrom": {
            "title": "Scrape From",
            "enum": [
              "All"
            ],
            "type": "string",
            "description": "Search across all Zillow pages.",
            "default": "All"
          },
          "emailType": {
            "title": "Email Type",
            "enum": [
              "B2C",
              "B2B"
            ],
            "type": "string",
            "description": "Choose one — B2C or B2B.",
            "default": "B2C"
          },
          "engine": {
            "title": "Engine",
            "enum": [
              "cost-effective",
              "legacy"
            ],
            "type": "string",
            "description": "Choose scraping engine. 🚀 Cost Effective (New): Uses residential proxies with async requests for faster, cheaper scraping. 🔧 Legacy: Uses GOOGLE_SERP proxy with traditional selectors - more reliable but slower and more expensive.",
            "default": "legacy"
          },
          "maxEmails": {
            "title": "Max Emails",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Enter the maximum number of emails to collect.",
            "default": 10
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}