{
  "openapi": "3.0.1",
  "info": {
    "title": "Zillow B2B Email Scraper - Region & Engine Filters",
    "description": "🏡 Zillow B2B Email Scraper — generate Zillow B2B leads with multi-engine search. Filters by region and country, deduplicates aliases and returns each email with its source page title, URL and domain. 🔑 For proptech sales teams.",
    "version": "1.0",
    "x-build-id": "cW8Zed0p7qJII4vR5"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/insightflow~zillow-b2b-email-scraper-accurate-and-high-converting/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-insightflow-zillow-b2b-email-scraper-accurate-and-high-converting",
        "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/insightflow~zillow-b2b-email-scraper-accurate-and-high-converting/runs": {
      "post": {
        "operationId": "runs-sync-insightflow-zillow-b2b-email-scraper-accurate-and-high-converting",
        "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/insightflow~zillow-b2b-email-scraper-accurate-and-high-converting/run-sync": {
      "post": {
        "operationId": "run-sync-insightflow-zillow-b2b-email-scraper-accurate-and-high-converting",
        "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": [
          "searchTerms",
          "country",
          "sourceRegion",
          "maxEmails"
        ],
        "properties": {
          "searchTerms": {
            "title": "Search Terms",
            "type": "array",
            "description": "Zip codes, cities, or agent names to search for on Zillow.",
            "items": {
              "type": "string"
            }
          },
          "country": {
            "title": "Target 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": "Select the country for localized agent discovery.",
            "default": "United States"
          },
          "sourceRegion": {
            "title": "Content Type",
            "enum": [
              "All"
            ],
            "type": "string",
            "description": "Select content type: Agent Profiles (Default).",
            "default": "All"
          },
          "engine": {
            "title": "Scraping Engine",
            "enum": [
              "cost-effective",
              "legacy"
            ],
            "type": "string",
            "description": "Select your preferred scraping method. ⚡ Performance (New): Faster, cheaper, uses residential proxies. 🛡️ Standard: Reliable, uses GOOGLE_SERP proxy, but slower.",
            "default": "legacy"
          },
          "maxEmails": {
            "title": "Maximum Emails",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Limit the number of emails to collect.",
            "default": 20
          },
          "minLeadScore": {
            "title": "Minimum Lead Score",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "Drop any contact whose Lead Score (0-100) falls below this. Leave at 0 for no filter.",
            "default": 0
          },
          "mxLookup": {
            "title": "MX Lookup (verify the mail domain)",
            "type": "boolean",
            "description": "Resolve each address's domain to its mail servers. Adds the resolved MX hosts and the mail provider (Google Workspace, Microsoft 365, ...) to every result, and feeds the Lead Score. DNS-level only - it confirms the domain can receive mail, not that the individual mailbox exists.",
            "default": true
          },
          "requireMxRecord": {
            "title": "Only keep contacts whose domain has an MX record",
            "type": "boolean",
            "description": "Drop any contact whose domain provably accepts no mail. A lookup that times out or errors is treated as unknown and kept, so a DNS hiccup never silently deletes good leads.",
            "default": false
          },
          "mxTimeoutSecs": {
            "title": "MX lookup timeout (seconds)",
            "minimum": 1,
            "maximum": 15,
            "type": "integer",
            "description": "How long to wait for each DNS answer. Clamped to 1-15 seconds.",
            "default": 3
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}