Property Level

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>
post/v3/property/value_by_image

Response

Success

messagestring required

The operation's status message

job_idstring required

The identifier of the job

job_status_urlstring required

The URL to be used for checking the job status

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"
}