# Search homes for rent (v1)

Returns one page of 42 rentals in a US location with monthly rent (or a rent range for buildings with several units), pet policy, beds, baths, square feet, address, coordinates, photo and listing flags. An unknown location is rejected with a 422; a search nothing matches returns a `total` of 0.

- Platform: Realtor
- Request: `GET https://api.toolzerhub.com/v1/realtor/for-rent`
- Auth: `x-api-key` header
- Cost: 1 credit per successful request. Failed requests are not billed.
- Page: https://docs.toolzerhub.com/reference/realtor/search/get-realtor-for-rent

| Parameter | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `location` | query | yes | string | A US city and state (Austin, TX), ZIP code (78704), county (Travis County, TX), the location from an Autocomplete result, or a realtor.com search link. |
| `page` | query | no | integer | One-based page of 42 listings. realtor.com serves the first 9,996 listings of a search (page 238); narrow the search to reach the rest. Default: 1. |
| `sort` | query | no | enum: newest, price_low, price_high, largest, price_reduced | newest lists the most recently listed first. price_low, price_high, largest (by square feet) and price_reduced (most recent price cut first) break ties newest first. Default: newest. |
| `price_min` | query | no | integer | Lowest list price in US dollars. |
| `price_max` | query | no | integer | Highest list price in US dollars. |
| `beds_min` | query | no | integer | Fewest bedrooms. |
| `baths_min` | query | no | integer | Fewest bathrooms. |
| `property_type` | query | no | string | One or more of single_family, condos, townhomes, multi_family, duplex_triplex, mobile, farm, land, apartment, comma-separated. |

## Example request

```bash
curl "https://api.toolzerhub.com/v1/realtor/for-rent?location=<location>" \
  -H "x-api-key: $TOOLZERHUB_API_KEY"
```

Success responses are wrapped as `{ "data": ... }`. Errors return `{ "error": { "code", "status", "message", "retryable", "details" } }`. See https://docs.toolzerhub.com/docs/responses-and-errors.