{"id":17871486,"url":"https://github.com/sharpbit/zillow-deal-finder","last_synced_at":"2025-09-16T19:31:46.499Z","repository":{"id":37650733,"uuid":"203046017","full_name":"SharpBit/zillow-deal-finder","owner":"SharpBit","description":"A program used to find low-priced homes relative to the Zestimate","archived":false,"fork":false,"pushed_at":"2023-05-22T21:47:28.000Z","size":7,"stargazers_count":26,"open_issues_count":3,"forks_count":6,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-02-14T21:21:18.301Z","etag":null,"topics":["zillow","zillow-api","zillow-scraper"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SharpBit.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-08-18T19:11:52.000Z","updated_at":"2024-08-01T16:32:00.059Z","dependencies_parsed_at":"2024-08-01T16:42:01.486Z","dependency_job_id":null,"html_url":"https://github.com/SharpBit/zillow-deal-finder","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SharpBit%2Fzillow-deal-finder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SharpBit%2Fzillow-deal-finder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SharpBit%2Fzillow-deal-finder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SharpBit%2Fzillow-deal-finder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SharpBit","download_url":"https://codeload.github.com/SharpBit/zillow-deal-finder/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":229964351,"owners_count":18152031,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["zillow","zillow-api","zillow-scraper"],"created_at":"2024-10-28T10:34:26.555Z","updated_at":"2025-09-16T19:31:41.165Z","avatar_url":"https://github.com/SharpBit.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Zillow Deal Finder\n\n### How it Works\nIt searches for houses for purchase or rent in a given neighborhood and calculates the difference between the list price and the Zestimate® and recommends the houses with the best value. Property with list prices lower than the Zestimate will appear in green text, and property with list prices above the Zestimate will appear in red.\n\n### Keep in mind\n- Just because a list price is lower than a Zestimate or on the lower end of the value range doesn't mean you should purchase it.\n- There are many factors into buying a house such as location, taxes, environment, lot size, maintenance costs, property condition, comfortability, etc. Do **not** solely use this tool to make a purchase.\n- The 3rd property always needs to \"load\", therefore we cannot get any data about that property and it is removed.\n- This is technically not allowed as Zillow only allows collection of data through one of their APIs, and since they do not have an API to search for property in a neighborhood with specific filters, this scrapes their site to find those properties. However, parts of this project **do** use multiple APIs provided by Zillow. (They also require an end user product on a website and API branding to be located visibly on the website).\n\n### Config structure\nCreate a file called `config.json`, copy over the text from `config.json.example`, and edit the necessary information.\n```\n{\n    \"ZWSID\": \"Your ZWS-ID you got from registering\",\n    \"neighborhood\": \"Great Neck, NY\",\n    \"sort\": \"days\",           // sort by parameter: see options below\n    \"filters\": {\n        \"price_min\": 0,       // minimum house price\n        \"price_max\": 1000000, // maximum house price (leave at 0 for no maximum, -1 for rent only)\n        \"rent_min\": 0,        // minimum rent price\n        \"rent_max\": 3000,     // maximum rent price (leave at 0 for no maximum, -1 for purchase only)\n        \"beds\": \"2+\",         // Number of bedrooms (str) can be i, i+, 0 for studio: from 0-5, or -1 for Any\n        \"baths\": 3,           // Sets minimum number of baths: 0 (Any), 1, 1.5, 2, 3, or 4\n        \"sqft_min\": 1400,     // minimum square footage\n        \"sqft_max\": 3000      // maximum square footage (set to 0 for no maximum)\n    }\n}\n```\n**Sort options:**\n- \"priced\" - Sort by price from high to low\n- \"pricea\" - Sort by price from low to high\n- \"days\" - Sort by new\n- \"beds\" - Sort by bedrooms\n- \"baths\" - Sort by bathrooms\n- \"size\" - Sort by square footage\n- \"lot\" - Sort by lot size\n- \"zest\" - Sort by Zestimate price from high to low\n- \"zesta\" - Sort by Zestimate price from low to high\n\n\n### How to Use\nClone the repo:\n```bash\n$ git clone https://github.com/SharpBit/zillow-deal-finder\n$ cd zillow-deal-finder\n```\nInstall dependencies:\n```bash\n$ pip install -r requirements.txt\n```\nRun the file:\n```bash\n$ python app.py\n```\n\n### An Example\nConfiguration Used: (8/18/19)\n```json\n{\n    \"ZWSID\": \"censored\",\n    \"neighborhood\": \"Great Neck, NY\",\n    \"sort\": \"days\",\n    \"filters\": {\n        \"price_min\": 600000,\n        \"price_max\": 1000000,\n        \"rent_min\": 2000,\n        \"rent_max\": 4000,\n        \"beds\": \"3+\",\n        \"baths\": 3,\n        \"sqft_min\": 2000,\n        \"sqft_max\": 3000\n    }\n}\n```\nOutput:\n```\n----------------------------------------------------------------------------------------------------\nHouse for sale at $998,000 - 88 Wooleys Ln, Great Neck, NY 11023\nNo data\n\nWant to read more?\nHome Details: https://www.zillow.com/homedetails/88-Wooleys-Ln-Great-Neck-NY-11023/31067863_zpid/\nComparable Homes: http://www.zillow.com/homes/comps/31067863_zpid/\n----------------------------------------------------------------------------------------------------\nApartment for rent at $5,000/mo - 27 Olive St, Great Neck, NY 11020\nCurrent Zestimate: $4100 (Last updated: 08/17/2019)\nZestimate change in the last 30 days: $-400\nList Price relative to Zestimate: +900\n                                           v\nValuation Range: |=========================|\n              $2501                   $4961\n\nWant to read more?\nHome Details: https://www.zillow.com/homedetails/27-Olive-St-Great-Neck-NY-11020/31098419_zpid/\nComparable Homes: http://www.zillow.com/homes/comps/31098419_zpid/\n----------------------------------------------------------------------------------------------------\nHouse for rent at $3,950/mo - 57 Berkshire Rd, Great Neck, NY 11023\nCurrent Zestimate: $4870 (Last updated: 08/17/2019)\nZestimate change in the last 30 days: $-13\nList Price relative to Zestimate: -920\n                 v\nValuation Range: |=========================|\n              $4578                   $6428\n\nWant to read more?\nHome Details: https://www.zillow.com/homedetails/57-Berkshire-Rd-Great-Neck-NY-11023/31062386_zpid/\nComparable Homes: http://www.zillow.com/homes/comps/31062386_zpid/\n----------------------------------------------------------------------------------------------------\nHouse for sale at $998,000 - 42 Jayson Ave, Great Neck, NY 11021\nCurrent Zestimate: $946904 (Last updated: 08/17/2019)\nZestimate change in the last 30 days: $-3933\nList Price relative to Zestimate: +51096\n                                           v\nValuation Range: |=========================|\n              $899559                   $994249\n\nWant to read more?\nHome Details: https://www.zillow.com/homedetails/42-Jayson-Ave-Great-Neck-NY-11021/31069745_zpid/\nComparable Homes: http://www.zillow.com/homes/comps/31069745_zpid/\n----------------------------------------------------------------------------------------------------\nHouse for sale at $995,000 - 7 Edgewood Pl, Great Neck, NY 11024\nCurrent Zestimate: $953803 (Last updated: 08/17/2019)\nZestimate change in the last 30 days: $-40617\nList Price relative to Zestimate: +41197\n                                        v\nValuation Range: |=========================|\n              $906113                   $1001493\n\nWant to read more?\nHome Details: https://www.zillow.com/homedetails/7-Edgewood-Pl-Great-Neck-NY-11024/31064142_zpid/\nComparable Homes: http://www.zillow.com/homes/comps/31064142_zpid/\n----------------------------------------------------------------------------------------------------\nFor sale by owner at $799,999 - 79 Susquehanna Ave, Great Neck, NY 11021\nCurrent Zestimate: $1256601 (Last updated: 08/17/2019)\nZestimate change in the last 30 days: $-24591\nList Price relative to Zestimate: -456602\n                 v\nValuation Range: |=========================|\n              $1093243                   $1407393\n\nWant to read more?\nHome Details: https://www.zillow.com/homedetails/79-Susquehanna-Ave-Great-Neck-NY-11021/31069200_zpid/\nComparable Homes: http://www.zillow.com/homes/comps/31069200_zpid/\n----------------------------------------------------------------------------------------------------\nHouse for sale at $855,000 - 8 Windsor Rd, Great Neck, NY 11021\nCurrent Zestimate: $875479 (Last updated: 08/17/2019)\nZestimate change in the last 30 days: $-11081\nList Price relative to Zestimate: -20479\n                        v\nValuation Range: |=========================|\n              $831705                   $919253\n\nWant to read more?\nHome Details: https://www.zillow.com/homedetails/8-Windsor-Rd-Great-Neck-NY-11021/31068433_zpid/\nComparable Homes: http://www.zillow.com/homes/comps/31068433_zpid/\n----------------------------------------------------------------------------------------------------\nHouse for sale at $938,000 - 10 Pickwood Ln, Great Neck, NY 11024\nCurrent Zestimate: $904258 (Last updated: 08/17/2019)\nZestimate change in the last 30 days: $-98\nList Price relative to Zestimate: +33742\n                                       v\nValuation Range: |=========================|\n              $859045                   $949471\n\nWant to read more?\nHome Details: https://www.zillow.com/homedetails/10-Pickwood-Ln-Great-Neck-NY-11024/31065937_zpid/\nComparable Homes: http://www.zillow.com/homes/comps/31065937_zpid/\n----------------------------------------------------------------------------------------------------\nHouse for sale at $999,000 - 25 Willow Ln, Great Neck, NY 11023\nCurrent Zestimate: $964876 (Last updated: 08/17/2019)\nZestimate change in the last 30 days: $46016\nList Price relative to Zestimate: +34124\n                                      v\nValuation Range: |=========================|\n              $916632                   $1013120\n\nWant to read more?\nHome Details: https://www.zillow.com/homedetails/25-Willow-Ln-Great-Neck-NY-11023/31065642_zpid/\nComparable Homes: http://www.zillow.com/homes/comps/31065642_zpid/\n----------------------------------------------------------------------------------------------------\nHouse for sale at $798,000 - 1 Shadow Ln, Great Neck, NY 11021\nCurrent Zestimate: $771617 (Last updated: 08/17/2019)\nZestimate change in the last 30 days: $-17138\nList Price relative to Zestimate: +26383\n                                      v\nValuation Range: |=========================|\n              $733036                   $810198\n\nWant to read more?\nHome Details: https://www.zillow.com/homedetails/1-Shadow-Ln-Great-Neck-NY-11021/31068474_zpid/\nComparable Homes: http://www.zillow.com/homes/comps/31068474_zpid/\n----------------------------------------------------------------------------------------------------\nHouse for sale at $948,000 - 2 Sheffield Rd, Great Neck, NY 11021\nCurrent Zestimate: $916653 (Last updated: 08/17/2019)\nZestimate change in the last 30 days: $-646\nList Price relative to Zestimate: +31347\n                                      v\nValuation Range: |=========================|\n              $870820                   $962486\n\nWant to read more?\nHome Details: https://www.zillow.com/homedetails/2-Sheffield-Rd-Great-Neck-NY-11021/31066245_zpid/\nComparable Homes: http://www.zillow.com/homes/comps/31066245_zpid/\n----------------------------------------------------------------------------------------------------\nHouse for sale at $999,999 - 200 Overlook Ave, Great Neck, NY 11021\nCurrent Zestimate: $941294 (Last updated: 08/17/2019)\nZestimate change in the last 30 days: $-37208\nList Price relative to Zestimate: +58705\n                                           v\nValuation Range: |=========================|\n              $894229                   $988359\n\nWant to read more?\nHome Details: https://www.zillow.com/homedetails/200-Overlook-Ave-Great-Neck-NY-11021/31069188_zpid/\nComparable Homes: http://www.zillow.com/homes/comps/31069188_zpid/\n----------------------------------------------------------------------------------------------------\nHouse for sale at $950,000 - 35 Valley View Rd, Great Neck, NY 11021\nCurrent Zestimate: $911318 (Last updated: 08/17/2019)\nZestimate change in the last 30 days: $-24152\nList Price relative to Zestimate: +38682\n                                        v\nValuation Range: |=========================|\n              $865752                   $956884\n\nWant to read more?\nHome Details: https://www.zillow.com/homedetails/35-Valley-View-Rd-Great-Neck-NY-11021/31068282_zpid/\nComparable Homes: http://www.zillow.com/homes/comps/31068282_zpid/\n----------------------------------------------------------------------------------------------------\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsharpbit%2Fzillow-deal-finder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsharpbit%2Fzillow-deal-finder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsharpbit%2Fzillow-deal-finder/lists"}