{
  "openapi": "3.0.1",
  "info": {
    "title": "House Flipper Leads - Zillow Listings + Flip Score, ARV, MAO",
    "description": "Bulk Zillow active listings for house flippers. Filter by city/state, price, beds/baths/sqft, year built, days on market, price drops. Auto-computes flip score, ARV estimate, rehab cost, MAO (70% rule), and detects distress keywords (as-is, fixer, motivated seller, etc).",
    "version": "0.1",
    "x-build-id": "vqeoQO4eAlltM9jLr"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/seibs.co~house-flipper-leads/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-seibs.co-house-flipper-leads",
        "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/seibs.co~house-flipper-leads/runs": {
      "post": {
        "operationId": "runs-sync-seibs.co-house-flipper-leads",
        "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/seibs.co~house-flipper-leads/run-sync": {
      "post": {
        "operationId": "run-sync-seibs.co-house-flipper-leads",
        "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": [
          "locations"
        ],
        "properties": {
          "locations": {
            "title": "Locations",
            "maxItems": 25,
            "type": "array",
            "description": "US locations to search. Format: 'City, ST'. Example: ['Austin, TX', 'Dallas, TX', 'Tampa, FL']. Max 25 locations per run.",
            "default": [
              "Austin, TX"
            ],
            "items": {
              "type": "string"
            }
          },
          "min_price": {
            "title": "Min list price (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Lower bound on Zillow list price. Leave blank for no minimum."
          },
          "max_price": {
            "title": "Max list price (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Upper bound on Zillow list price. Flippers usually cap here to keep MAO realistic."
          },
          "min_beds": {
            "title": "Min bedrooms",
            "minimum": 0,
            "maximum": 20,
            "type": "integer",
            "description": "Minimum number of bedrooms (inclusive). Leave blank for no floor."
          },
          "max_beds": {
            "title": "Max bedrooms",
            "minimum": 0,
            "maximum": 20,
            "type": "integer",
            "description": "Maximum number of bedrooms (inclusive). Leave blank for no ceiling."
          },
          "min_baths": {
            "title": "Min bathrooms",
            "minimum": 0,
            "maximum": 20,
            "type": "number",
            "description": "Minimum number of bathrooms (decimals OK, e.g. 1.5). Leave blank for no floor."
          },
          "min_sqft": {
            "title": "Min living area (sqft)",
            "minimum": 0,
            "type": "integer",
            "description": "Minimum interior living area in square feet. Leave blank for no floor."
          },
          "max_sqft": {
            "title": "Max living area (sqft)",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum interior living area in square feet. Leave blank for no ceiling."
          },
          "min_year_built": {
            "title": "Min year built",
            "minimum": 1800,
            "maximum": 2030,
            "type": "integer",
            "description": "Minimum year built (inclusive). Set to 1970 to focus on older inventory with more rehab opportunity. Leave blank for no floor."
          },
          "max_year_built": {
            "title": "Max year built",
            "minimum": 1800,
            "maximum": 2030,
            "type": "integer",
            "description": "Older properties usually score higher for flip potential. Leave high to allow all."
          },
          "home_types": {
            "title": "Home types",
            "uniqueItems": true,
            "type": "array",
            "description": "Property types to include. SingleFamily is the default flipper target.",
            "items": {
              "type": "string",
              "enum": [
                "SingleFamily",
                "Townhouse",
                "MultiFamily",
                "Condo",
                "Manufactured",
                "LotLand"
              ]
            },
            "default": [
              "SingleFamily"
            ]
          },
          "include_foreclosures": {
            "title": "Include foreclosures",
            "type": "boolean",
            "description": "Include foreclosure / REO / pre-foreclosure listings alongside regular for-sale homes.",
            "default": true
          },
          "only_foreclosures": {
            "title": "Only foreclosures",
            "type": "boolean",
            "description": "Restrict to foreclosure / REO / bank-owned listings.",
            "default": false
          },
          "only_fsbo": {
            "title": "Only FSBO",
            "type": "boolean",
            "description": "Restrict to For-Sale-By-Owner listings (no agent fees, often more motivated sellers).",
            "default": false
          },
          "days_on_zillow_min": {
            "title": "Min days on Zillow",
            "minimum": 0,
            "maximum": 1000,
            "type": "integer",
            "description": "Only return listings that have been on Zillow at least this many days. Common buckets: 30 (moderate aging), 60 (motivated seller territory), 90 (very motivated), 180+ (stale, often distressed). Leave blank to skip."
          },
          "has_price_drop": {
            "title": "Has price drop",
            "type": "boolean",
            "description": "Filter to listings that have had at least one price reduction on Zillow.",
            "default": false
          },
          "min_flip_score": {
            "title": "Min flip score (0.0 - 1.0)",
            "type": "string",
            "description": "Drop records whose computed flip score is below this threshold. 0.6+ = high-confidence flip candidate. Leave blank to emit everything. Enter as a decimal between 0.0 and 1.0 (e.g. 0.5).",
            "default": ""
          },
          "enrich_details": {
            "title": "Enrich detail pages",
            "type": "boolean",
            "description": "Fetch each listing's detail page for description, photos, price history, and nearby comps. Adds $0.005 per enriched record.",
            "default": true
          },
          "enrich_concurrency": {
            "title": "Enrichment concurrency",
            "minimum": 1,
            "maximum": 16,
            "type": "integer",
            "description": "Parallel detail-page fetches. 4 is the safe default; raise cautiously if Zillow doesn't rate-limit. 16 is the hard ceiling.",
            "default": 4
          },
          "use_apify_proxy": {
            "title": "Use Apify Proxy",
            "type": "boolean",
            "description": "Strongly recommended. Zillow aggressively blocks datacenter IPs. RESIDENTIAL is required.",
            "default": true
          },
          "apify_proxy_groups": {
            "title": "Apify proxy groups",
            "type": "array",
            "description": "Proxy groups to use. RESIDENTIAL is required for Zillow.",
            "default": [
              "RESIDENTIAL"
            ],
            "items": {
              "type": "string"
            }
          },
          "apify_proxy_country": {
            "title": "Apify proxy country",
            "type": "string",
            "description": "Two-letter country code for residential proxy (e.g. 'US'). Leave blank for any.",
            "default": "US"
          },
          "max_results_per_location": {
            "title": "Max results per location",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "Cap on listings returned per location. Hard ceiling: 100 to keep compute cost predictable.",
            "default": 100
          },
          "max_pages_per_location": {
            "title": "Max search pages per location",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "Zillow paginates ~40 results per page. 5 pages = ~200 listings max per location.",
            "default": 5
          },
          "preset_filter": {
            "title": "Preset filter (optional)",
            "enum": [
              "",
              "conservative_flipper",
              "aggressive_flipper",
              "brrrr_investor",
              "wholesaler"
            ],
            "type": "string",
            "description": "Apply a flipper-strategy preset. User-supplied fields below override the preset.",
            "default": ""
          },
          "min_lot_sqft": {
            "title": "Min lot size (sqft)",
            "minimum": 0,
            "type": "integer",
            "description": "Lot area floor in sqft. 43560 = 1 acre. Useful for finding subdivide/ADU opportunities."
          },
          "max_lot_sqft": {
            "title": "Max lot size (sqft)",
            "minimum": 0,
            "type": "integer",
            "description": "Lot area ceiling in sqft. Leave blank for no ceiling."
          },
          "max_hoa_fee": {
            "title": "Max HOA fee per month ($)",
            "minimum": 0,
            "type": "integer",
            "description": "Drop listings with monthly HOA above this. High HOAs kill flip math (eat into holding cost). 100 is a strict filter; 300 is moderate."
          },
          "min_school_rating": {
            "title": "Min school rating (1-10)",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "Drop listings whose best nearby school rates below this (impacts ARV directly). Requires enrich_details=true."
          },
          "sort_order": {
            "title": "Sort order",
            "enum": [
              "best_deals",
              "newest",
              "lowest_price",
              "biggest_discount",
              "largest_sqft",
              "oldest_built"
            ],
            "type": "string",
            "description": "How Zillow returns results. 'best_deals' is the default global relevance ranking; 'biggest_discount' surfaces price-drop listings first.",
            "default": "best_deals"
          },
          "must_include_keywords": {
            "title": "Required keywords (must all appear in description)",
            "type": "array",
            "description": "Server-side filter: only emit listings whose description contains ALL of these case-insensitive substrings. Example: ['as-is', 'cash'].",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "must_exclude_keywords": {
            "title": "Excluded keywords (drop if any appear)",
            "type": "array",
            "description": "Drop any listing whose description contains ANY of these case-insensitive substrings. Example: ['turnkey', 'renovated', 'new construction'].",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "only_absentee_owners": {
            "title": "Only absentee owners",
            "type": "boolean",
            "description": "Drop listings where the owner's mailing address matches the property address. Absentee owners (landlords, out-of-state heirs) are typically more flexible on price. Requires enrich_details=true.",
            "default": false
          },
          "estimated_rehab_months": {
            "title": "Estimated rehab months (for holding cost)",
            "minimum": 1,
            "maximum": 18,
            "type": "integer",
            "description": "How long you expect rehab + listing + closing to take. Used to estimate total holding cost (mortgage interest + tax + utilities + HOA) during the project.",
            "default": 4
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}