{"id":20162113,"url":"https://github.com/ralucas/node-zillow","last_synced_at":"2025-08-21T15:31:29.460Z","repository":{"id":16307799,"uuid":"19056672","full_name":"ralucas/node-zillow","owner":"ralucas","description":"Node wrapper for Zillow API","archived":false,"fork":false,"pushed_at":"2020-09-28T06:09:45.000Z","size":156,"stargazers_count":70,"open_issues_count":4,"forks_count":27,"subscribers_count":9,"default_branch":"master","last_synced_at":"2024-12-07T14:51:24.748Z","etag":null,"topics":["nodejs","zillow","zillow-api"],"latest_commit_sha":null,"homepage":"https://ralucas.github.io/node-zillow","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ralucas.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE-MIT","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-04-23T04:14:45.000Z","updated_at":"2024-08-01T02:09:33.000Z","dependencies_parsed_at":"2022-09-11T23:11:55.287Z","dependency_job_id":null,"html_url":"https://github.com/ralucas/node-zillow","commit_stats":{"total_commits":60,"total_committers":3,"mean_commits":20.0,"dds":"0.15000000000000002","last_synced_commit":"236aa710b60fd3713bf1245be163cd64c2045985"},"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ralucas%2Fnode-zillow","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ralucas%2Fnode-zillow/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ralucas%2Fnode-zillow/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ralucas%2Fnode-zillow/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ralucas","download_url":"https://codeload.github.com/ralucas/node-zillow/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":230520391,"owners_count":18238948,"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":["nodejs","zillow","zillow-api"],"created_at":"2024-11-14T00:23:21.373Z","updated_at":"2024-12-20T01:14:40.846Z","avatar_url":"https://github.com/ralucas.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# node-zillow [![Build Status](https://secure.travis-ci.org/ralucas/node-zillow.png?branch=master)](http://travis-ci.org/ralucas/node-zillow) [![Coverage Status](https://coveralls.io/repos/github/ralucas/node-zillow/badge.svg)](https://coveralls.io/github/ralucas/node-zillow)\n\nNode wrapper for the Zillow API\n\n## Getting Started\nInstall the module with: `npm install node-zillow`\n\n```js\nvar Zillow = require('node-zillow');\n\n//Instantiate\nvar zillow = new Zillow('your zws-id', options);\n```\n`var your-zws-id = process.env.ZWSID` is the recommended way\n\n#### Accepted options\nhttps - default is `false`\n\n__None of this will make sense without reading the [Zillow API Docs](http://www.zillow.com/howto/api/APIOverview.htm)__\n\n__Also be sure to follow the Zillow API [terms of use](http://www.zillow.com/howto/api/APITerms.htm) and [branding requirements](http://www.zillow.com/howto/api/BrandingRequirements.htm)__\n\n## Documentation\n\n### Methods\n\n`get`\n- Method for the entire zillow api\n- takes the name of the api call (i.e. GetSearchResults) -- refer to the [Zillow API Docs](http://www.zillow.com/howto/api/APIOverview.htm), the `lib/api-list.js`, or see below\n- Returns a promise with the result\n- The eventual returned result is an object with the following properties: `message`, `request`, and sometimes `response`\n- Please Note: `response` property is NOT always included in the zillow api response\n\n#### Following API Methods supported:\n* GetDeepSearchResults\n* GetUpdatedPropertyDetails\n* GetDeepComps\n* GetRateSummary\n* GetMonthlyPayments\n* GetDemographics\n* GetRegionChildren\n* GetRegionChart\n* GetSearchResults\n* GetZestimate\n* GetChart\n* GetComps\n\n## Examples\n\nExample of all API calls through the `get()` method can be found in [examples](https://github.com/ralucas/node-zillow/blob/master/examples/examples.js)\n\n```js\nvar Zillow  = require('node-zillow')\n\nvar zwsid = process.env.ZWSID\nvar zillow = new Zillow(zwsid)\n\nvar parameters = {\n  zpid: 1111111\n};\n\nzillow.get('GetZestimate', parameters)\n  .then(function(results) {\n    return results;\n    // results here is an object { message: {}, request: {}, response: {}} \n  })\n```\n\nThe following API calls are deprecated and will be removed in the 1.0.0 release. Using `get()` is the recommended approach and should be able to do everthing that the legacy functions do. If you see problems with `get()`, PR's and issues are welcome.\n\n```js\nZillow.callApi()\nZillow.getDeepSearchResults()\nZillow.getUpdatedPropertyDetails()\nZillow.getDemographics()\n```\n\n## Contributing\nThis module uses promises via the Q library.  Please continue to use promises. And in lieu of any further formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using npm scripts in the `package.json`.\n\n## Contributors\n\n* [Jeff Friesen](https://github.com/jefffriesen)\n* [Richard Lucas](https://github.com/ralucas)\n\n## Release History\n* v2.0.0 - Updated all dependencies. Remove support for Node.js v0.10.x.\n* v1.1.0 - Updated all dependencies, removed grunt, moved to istanbul, added coveralls, more ci environments\n* v1.0.1 - Added protocol option\n* v1.0.0 - Created single method (get), updated response handling, removed all deprecated methods, updated tests\n* v0.0.5 - updates\n* v0.0.4 - Added error-checking and parameter checking\n* v0.0.3 - Includes the following methods: callApi, getUpdatedPropertyDetails, getDeepSearchResults, getDemographics\n\n## License\nCopyright (c) 2014-2018 Richard Lucas. Licensed under the MIT license.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fralucas%2Fnode-zillow","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fralucas%2Fnode-zillow","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fralucas%2Fnode-zillow/lists"}