---
title: "Property Search API — 3 Endpoints | Homesage.ai"
description: "Search the US property database on 155M+ US homes by investment criteria. 3 endpoints: resolve a search area, preview match count and cost, then run the full…"
---

# Property Search

The Homesage.ai Property Search API finds properties matching investment filters across the US database. It runs in three steps: resolve a place name into a search-area object (free), preview how many properties match and what the search will cost (free), then run it at 1 credit per property returned.

## [Resolve a city / county / ZIP name into a search-area object (free)](https://app.homesage.ai/docs/property-search/area-autocomplete)

`GET /api/area/autocomplete/`

Up to 5 area suggestions (city, county, or ZIP) matching a partial place name — each a structured object you pass straight into the location filter of preview_property_search / run_property_search.

## [Preview a property-database search — free match count + credit cost](https://app.homesage.ai/docs/property-search/preview-property-search)

`GET /api/workspace/search/count/`

A free preview of a property-database search: count (how many properties match the filters) and cost (the credits the full search would charge).

## [Search the property database by investment criteria (1 credit per result)](https://app.homesage.ai/docs/property-search/run-property-search)

`POST /api/workspace/search/`

The full set of properties matching your investment filters — each with valuation, investment metrics, condition, and location detail.