Value by Image
This set of endpoints returns property value estimates based on submitted property images. Up to 20 images are accepted per request and a larger set of images will yield more accurate results. First, submit property images and an address to the POST value_by_image endpoint to receive a job_id and block_group_id. Then poll the GET value_by_image_job endpoint, passing the returned job_id and block_group_id, until job completion. When the job has finished, the property’s adjusted condition score and conditioned-based AVM (Automated Valuation Model) and FSD will be returned. Note: please do not poll the GET value_by_image_job endpoint more frequently than once per second to avoid interruptions from our firewall.
Source: HouseCanary
Pricing Tier: Premium Plus
Updated: Annually
Request Body Fields
<table><tr><th>Field</th><th>Type</th><th>Description</th><th>Example</th></tr> <tr><td>address</td><td>string</td><td>JSON-encoded address object</td><td>{"slug":null,"city":"Gilbert","state":"AZ","unit":"","address":"1624 E Dogwood Ln","zipcode":"85295"}</td> </tr> <tr><td>images</td><td>array</td><td>Up to 20 images are accepted per request and a larger set of images will yield more accurate results.</td><td></td> </tr> <tr><td>images[]</td><td>string</td><td>Binary image data</td><td>file</td> </tr> </table>Response
<table><tr><th>Field</th><th>Type</th><th>Description</th><th>Example</th></tr> <tr><td>message</td><td>string</td><td>The operation's status message</td><td>Job submitted</td> </tr> <tr><td>job_id</td><td>string</td><td>The identifier of the job</td><td>11848</td> </tr> <tr><td>job_status_url</td><td>string</td><td>The URL to be used for checking the job status</td><td>/property/value_by_image_job/11848?block_group_id=040138155022&slug=1624-E-Dogwood-Ln-Gilbert-AZ-85295</td> </tr> </table>Response
Success
Example response
{
"message": "Job submitted",
"job_id": "11848",
"job_status_url": "/property/value_by_image_job/11848?block_group_id=040138155022&slug=1624-E-Dogwood-Ln-Gilbert-AZ-85295"
}