Real estate listings

We built real estate search so you can pull homes for sale, for rent, or recently sold in any US or Canadian location, with prices, value and rent estimates, and listing details, as JSON. It covers all 50 US states, D.C., Puerto Rico, and all 13 Canadian provinces and territories.

Listings come back current, because we fetch them on every call.

Inputs

Give a location, either as a structured city and state or province, or as free text:

{
  "apiKey": "sk_live_...",
  "location": { "type": "structured", "city": "Austin", "stateCode": "TX" },
  "listingStatus": "forSale",
  "homeTypes": ["house", "townhouse"],
  "price": { "min": 400000, "max": 750000 },
  "bedrooms": { "min": 3 },
  "sortBy": "newest"
}

Use { "type": "raw", "rawQuery": "..." } for a neighborhood, ZIP code, or anything that doesn't split cleanly into city and state.

Filters:

• listingStatus: forSale, forRent, or sold
• homeTypes: house, condo, townhouse, multi_family, apartment, land, manufactured
• price and rent ranges, bedrooms (minimum 1–5), bathrooms (minimum 1–4), floorAreaSqFt, lotAreaSqFt, yearBuilt, parkingSpots
• features: pool, garage, air conditioning, waterfront, single story, open house, and whether to include homes under contract
• keywords to match listing text
• sortBy: relevance, newest, priceAscending, priceDescending, paymentAscending, paymentDescending, estimatedPriceAscending, estimatedPriceDescending, bedroomCountDescending, bathroomCountDescending, floorAreaSqFtDescending, lotAreaSqFtDescending

What comes back

Each listing includes its address and location, price (in local currency and US dollars), an estimated value and estimated monthly rent, recent price changes, bedrooms and bathrooms, floor and lot area, home type, tax assessed value, the listing broker, and photos. Page through results with nextPageToken.

Operations

The endpoint allows 300 requests per minute. Set a 30-second client timeout.

Errors

Using it effectively

• Use structured locations when you can. A city plus state code is the most reliable way to land on the right market.
• Compare value and rent estimates to screen rental yield across a market in one pass.
• Keep the same filters while paging. A page token belongs to one search.

Credits

2 credits per page of results. If we can't find listings for your location (404), or the request fails, you're refunded. See Billing & credits.

Credit amounts are defaults — custom pricing is available for bulk use cases.

Related: Market intelligence