# Realtor Auto Suggestion (AutoFill) (`kawsar/realtor-auto-suggestion`) Actor

Realtor.com location autocomplete scraper that returns addresses, cities, ZIP codes, schools, and neighborhoods for any search query, so developers can build autofill UIs and validate locations affordably.

- **URL**: https://apify.com/kawsar/realtor-auto-suggestion.md
- **Developed by:** [Kawsar](https://apify.com/kawsar) (community)
- **Categories:** Developer tools, Real estate
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

$1.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## Realtor Auto Suggest: Location Autocomplete and Address Lookup for Realtor.com

<p align="center">
  <img src="https://images.bigibyte.com/cdn-cgi/image/width=560,fit=scale-down,format=webp/apify-kawsar-Realtor-Suggest-AutoFill.webp" alt="Realtor Auto Suggest Actor Cover">
</p>

Scrape Realtor.com's autocomplete suggestions for any search term. Type a partial address, city name, ZIP code, or neighborhood, and this actor returns every matching location from Realtor.com's internal suggestion database, complete with GPS coordinates, area types, and property IDs.

You feed it one or more queries, toggle which location types you care about (addresses, cities, schools, ZIP codes, etc.), and get back clean, structured data for each match. If a query has no results, you still get a row back with the original search term so you know it came up empty.

---

### What can you look up?

This actor taps into the same autocomplete endpoint that powers the Realtor.com search bar. It returns suggestions across 12 location types:

- **Addresses**: Full property addresses with property IDs and coordinates
- **Cities**: City-level matches with state codes
- **Neighborhoods**: Named subdivisions and areas within a city
- **ZIP codes**: Postal code lookups
- **Counties**: County-level results with FIPS-style identifiers
- **Streets**: Whole-street results without a specific house number
- **Schools**: Individual K-12 schools
- **School districts**: District-level results
- **Universities**: Colleges and universities
- **Parks**: Parks and recreation areas
- **States**: Full state matches
- **MLS IDs**: Direct MLS listing ID lookups

---

### Use cases

- **Address validation**: Verify a user-entered address actually exists on Realtor.com before running a more expensive property lookup
- **Building search UIs**: Power an autocomplete dropdown in your own real estate application using real Realtor.com suggestions
- **Lead enrichment**: Take partial addresses or city names from a CRM and expand them into full, validated locations
- **Geographic research**: Look up all neighborhoods, schools, and parks within a city or region
- **MLS cross-referencing**: Validate MLS IDs against Realtor.com's database
- **Data normalization**: Convert messy user input ("nyc", "new york city", "Manhattan NY") into standardized city/state/ZIP records

---

### Input Parameters

#### Search

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `queries` | array | Yes | `["New York", "11150 Glenoaks", "90210", "Austin TX", "Stanford University"]` | Search terms to look up. One API call per query. Example: `["New York", "11150 Glenoaks", "90210", "Austin TX", "Stanford University"]`. |
| `limit` | integer | No | `100` | Max suggestions per query. Max 10,000. |

#### Location type toggles

All enabled by default. Set any to `false` to exclude that type from results.

| Parameter | Type | Default | Controls |
|-----------|------|---------|----------|
| `includeAddress` | boolean | `true` | Street addresses |
| `includeNeighborhood` | boolean | `true` | Named neighborhoods |
| `includeCity` | boolean | `true` | Cities |
| `includeCounty` | boolean | `true` | Counties |
| `includePostalCode` | boolean | `true` | ZIP/postal codes |
| `includeStreet` | boolean | `true` | Whole streets |
| `includeSchool` | boolean | `true` | Individual schools |
| `includeSchoolDistrict` | boolean | `true` | School districts |
| `includeUniversity` | boolean | `true` | Colleges/universities |
| `includePark` | boolean | `true` | Parks |
| `includeState` | boolean | `true` | US states |
| `includeMlsId` | boolean | `true` | MLS listing IDs |

#### Limits

| Parameter | Type | Default | Max | Description |
|-----------|------|---------|-----|-------------|
| `timeoutSecs` | integer | `300` | `3600` | Overall actor runtime cap in seconds. |
| `requestTimeoutSecs` | integer | `30` | `120` | Per-request timeout in seconds. |

#### Proxy

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `proxyConfiguration` | object | US Datacenter | Apify proxy settings. Default uses US datacenter proxies. |

---

### Example Input: Mixed query batch

```json
{
    "queries": [
        "New York",
        "11150 Glenoaks",
        "90210",
        "Austin TX",
        "Stanford University"
    ],
    "limit": 50,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyCountry": "US"
    }
}
````

### Example Input: Only addresses and ZIP codes

```json
{
    "queries": ["123 Main", "90210", "Beverly Hills"],
    "includeAddress": true,
    "includePostalCode": true,
    "includeCity": false,
    "includeCounty": false,
    "includeNeighborhood": false,
    "includeStreet": false,
    "includeSchool": false,
    "includeSchoolDistrict": false,
    "includeUniversity": false,
    "includePark": false,
    "includeState": false,
    "includeMlsId": false,
    "limit": 100,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyCountry": "US"
    }
}
```

### Example Input: School lookup

```json
{
    "queries": ["Lincoln High School", "Stanford"],
    "includeSchool": true,
    "includeSchoolDistrict": true,
    "includeUniversity": true,
    "includeAddress": false,
    "includeCity": false,
    "includeCounty": false,
    "includeNeighborhood": false,
    "includePostalCode": false,
    "includeStreet": false,
    "includePark": false,
    "includeState": false,
    "includeMlsId": false,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyCountry": "US"
    }
}
```

***

### Output: Full field reference

Each autocomplete suggestion is pushed as a flat JSON record:

```json
{
    "searchQuery": "New York",
    "areaType": "city",
    "fullAddress": "New York, NY",
    "line": "",
    "cityName": "New York",
    "stateCode": "NY",
    "postalCode": "",
    "countryCode": "US",
    "latitude": 40.7128,
    "longitude": -74.006,
    "mlsId": "",
    "propertyId": "",
    "slug": "New-York_NY",
    "scrapedAt": "2024-06-15T10:30:00.000000+00:00",
    "error": null
}
```

#### Output fields explained

| Field | Type | Description |
|-------|------|-------------|
| `searchQuery` | string | The original query you submitted. Always present, even on empty results. |
| `areaType` | string | Category: `address`, `city`, `neighborhood`, `county`, `postal_code`, `street`, `school`, `school_district`, `university`, `park`, `state`, `mlsid`. |
| `fullAddress` | string | Complete formatted location string as displayed by Realtor.com. |
| `line` | string | Street address line (house number + street). Empty for non-address types. |
| `cityName` | string | City name. |
| `stateCode` | string | 2-letter US state code. |
| `postalCode` | string | ZIP code. |
| `countryCode` | string | Country code (usually `US`). |
| `latitude` | number | GPS latitude. `null` if not available. |
| `longitude` | number | GPS longitude. `null` if not available. |
| `mlsId` | string | MLS listing ID. Only populated for MLS-type results. |
| `propertyId` | string | Realtor.com property ID. Only populated for address-type results. |
| `slug` | string | URL-friendly identifier for the location. |
| `scrapedAt` | string | ISO 8601 timestamp of when the data was pulled. |
| `error` | string | Error message if the query failed, or "No suggestions found" for empty results. `null` on success. |

***

### How it works

1. You provide one or more search queries (city names, partial addresses, ZIP codes, etc.)
2. The actor checks your boolean toggles and builds the list of area types to request
3. For each query, it calls Realtor.com's internal autocomplete API using US datacenter proxies
4. It rotates proxy IPs between queries to avoid rate limits
5. Each suggestion is flattened into a clean JSON record and pushed to your dataset
6. If a query returns zero suggestions, a record is still pushed with the original search term and an error note, so you know which queries came up empty

***

### Tips

- Type partial text and the API completes it. "aus" returns "Austin, TX", "Australia", etc. You do not need to type the full name.
- If you only need specific location types (just cities, just addresses), turn off the others using the boolean toggles. This reduces noise in your results.
- The `searchQuery` field is always included in every output row. This makes it easy to join results back to your input data, even when a query has no matches.
- Most queries return 10-50 suggestions. Setting `limit` to 100 covers the vast majority of use cases.

***

### Frequently asked questions

**What happens if my search term has no results?**\
The actor pushes a single record with your original query in `searchQuery` and an error note saying "No suggestions found for this query." Your data will never silently drop a query.

**Can I batch multiple searches in one run?**\
Yes. Put all your queries in the `queries` array. The actor processes them one by one, rotating proxies between each. Example: `["New York", "90210", "Austin TX", "Stanford University"]`.

**What if I pass a string instead of an array for queries?**\
The actor handles this automatically. It splits comma-separated strings into individual queries.

**How accurate are the GPS coordinates?**\
The latitude and longitude come directly from Realtor.com's geocoding. For addresses, they point to the property. For cities, they point to the city center.

**Can I look up MLS listing IDs?**\
Yes. Make sure `includeMlsId` is enabled (it is by default), and type the MLS ID as your query. If Realtor.com recognizes it, you get the match back.

***

### Integrations

Connect Realtor Auto Suggest with other apps using [Apify integrations](https://apify.com/integrations). Push autocomplete results directly into Google Sheets, Slack, Make, Zapier, Airbyte, or any webhook endpoint. Use the [Apify API](https://docs.apify.com/api/v2) to trigger runs programmatically from any language.

# Actor input Schema

## `queries` (type: `array`):

One or more location search terms to look up. Each query triggers a separate autocomplete call. You can search for partial addresses, city names, ZIP codes, neighborhoods, schools, or anything you would type into the Realtor.com search bar. Example: \['New York', '11150 Glenoaks', '90210', 'Austin TX', 'Stanford University'].

## `limit` (type: `integer`):

Maximum number of autocomplete suggestions to return per search query. The Realtor.com API can return up to 10,000 suggestions per query, but most queries only have 10-50 useful matches. Default is 100. Example: 50 for quick lookups.

## `includeAddress` (type: `boolean`):

Include specific street addresses in the autocomplete results. Example: '123 Main St, Springfield, IL'. Default is enabled.

## `includeNeighborhood` (type: `boolean`):

Include named neighborhoods and subdivisions. Example: 'SoHo, New York, NY'. Default is enabled.

## `includeCity` (type: `boolean`):

Include city-level results. Example: 'Houston, TX'. Default is enabled.

## `includeCounty` (type: `boolean`):

Include county-level results. Example: 'Los Angeles County, CA'. Default is enabled.

## `includePostalCode` (type: `boolean`):

Include ZIP/postal code results. Example: '90210'. Default is enabled.

## `includeStreet` (type: `boolean`):

Include whole-street results (without a specific house number). Example: 'Sunset Blvd, Los Angeles, CA'. Default is enabled.

## `includeSchool` (type: `boolean`):

Include individual schools. Example: 'Lincoln High School, Portland, OR'. Default is enabled.

## `includeSchoolDistrict` (type: `boolean`):

Include school district results. Example: 'Los Angeles Unified School District'. Default is enabled.

## `includeUniversity` (type: `boolean`):

Include college and university results. Example: 'Stanford University, Stanford, CA'. Default is enabled.

## `includePark` (type: `boolean`):

Include parks and recreation areas. Example: 'Central Park, New York, NY'. Default is enabled.

## `includeState` (type: `boolean`):

Include state-level results. Example: 'California'. Default is enabled.

## `includeMlsId` (type: `boolean`):

Include MLS listing ID matches. Example: 'OC22183456'. Default is enabled.

## `timeoutSecs` (type: `integer`):

Maximum runtime for the entire actor in seconds. The actor stops when this time is exceeded. Default is 300 (5 minutes). Example: 600 for larger batches.

## `requestTimeoutSecs` (type: `integer`):

Maximum time to wait for the Realtor.com autocomplete server per query. Default is 30 seconds.

## `proxyConfiguration` (type: `object`):

Proxy settings for requests. Default uses Apify datacenter proxies.

## Actor input object example

```json
{
  "queries": [
    "New York",
    "11150 Glenoaks",
    "90210",
    "Austin TX",
    "Stanford University"
  ],
  "limit": 100,
  "includeAddress": true,
  "includeNeighborhood": true,
  "includeCity": true,
  "includeCounty": true,
  "includePostalCode": true,
  "includeStreet": true,
  "includeSchool": true,
  "includeSchoolDistrict": true,
  "includeUniversity": true,
  "includePark": true,
  "includeState": true,
  "includeMlsId": true,
  "timeoutSecs": 300,
  "requestTimeoutSecs": 30,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyCountry": "US"
  }
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "queries": [
        "New York",
        "11150 Glenoaks",
        "90210",
        "Austin TX",
        "Stanford University"
    ],
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyCountry": "US"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("kawsar/realtor-auto-suggestion").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "queries": [
        "New York",
        "11150 Glenoaks",
        "90210",
        "Austin TX",
        "Stanford University",
    ],
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyCountry": "US",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("kawsar/realtor-auto-suggestion").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "queries": [
    "New York",
    "11150 Glenoaks",
    "90210",
    "Austin TX",
    "Stanford University"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyCountry": "US"
  }
}' |
apify call kawsar/realtor-auto-suggestion --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=kawsar/realtor-auto-suggestion",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Realtor Auto Suggestion (AutoFill)",
        "description": "Realtor.com location autocomplete scraper that returns addresses, cities, ZIP codes, schools, and neighborhoods for any search query, so developers can build autofill UIs and validate locations affordably.",
        "version": "0.0",
        "x-build-id": "8N96Tf7glMiaU9NMb"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/kawsar~realtor-auto-suggestion/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-kawsar-realtor-auto-suggestion",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/kawsar~realtor-auto-suggestion/runs": {
            "post": {
                "operationId": "runs-sync-kawsar-realtor-auto-suggestion",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/kawsar~realtor-auto-suggestion/run-sync": {
            "post": {
                "operationId": "run-sync-kawsar-realtor-auto-suggestion",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "queries"
                ],
                "properties": {
                    "queries": {
                        "title": "Search queries",
                        "type": "array",
                        "description": "One or more location search terms to look up. Each query triggers a separate autocomplete call. You can search for partial addresses, city names, ZIP codes, neighborhoods, schools, or anything you would type into the Realtor.com search bar. Example: ['New York', '11150 Glenoaks', '90210', 'Austin TX', 'Stanford University'].",
                        "items": {
                            "type": "string"
                        }
                    },
                    "limit": {
                        "title": "Max suggestions per query",
                        "minimum": 1,
                        "maximum": 10000,
                        "type": "integer",
                        "description": "Maximum number of autocomplete suggestions to return per search query. The Realtor.com API can return up to 10,000 suggestions per query, but most queries only have 10-50 useful matches. Default is 100. Example: 50 for quick lookups.",
                        "default": 100
                    },
                    "includeAddress": {
                        "title": "Include addresses",
                        "type": "boolean",
                        "description": "Include specific street addresses in the autocomplete results. Example: '123 Main St, Springfield, IL'. Default is enabled.",
                        "default": true
                    },
                    "includeNeighborhood": {
                        "title": "Include neighborhoods",
                        "type": "boolean",
                        "description": "Include named neighborhoods and subdivisions. Example: 'SoHo, New York, NY'. Default is enabled.",
                        "default": true
                    },
                    "includeCity": {
                        "title": "Include cities",
                        "type": "boolean",
                        "description": "Include city-level results. Example: 'Houston, TX'. Default is enabled.",
                        "default": true
                    },
                    "includeCounty": {
                        "title": "Include counties",
                        "type": "boolean",
                        "description": "Include county-level results. Example: 'Los Angeles County, CA'. Default is enabled.",
                        "default": true
                    },
                    "includePostalCode": {
                        "title": "Include postal codes",
                        "type": "boolean",
                        "description": "Include ZIP/postal code results. Example: '90210'. Default is enabled.",
                        "default": true
                    },
                    "includeStreet": {
                        "title": "Include streets",
                        "type": "boolean",
                        "description": "Include whole-street results (without a specific house number). Example: 'Sunset Blvd, Los Angeles, CA'. Default is enabled.",
                        "default": true
                    },
                    "includeSchool": {
                        "title": "Include schools",
                        "type": "boolean",
                        "description": "Include individual schools. Example: 'Lincoln High School, Portland, OR'. Default is enabled.",
                        "default": true
                    },
                    "includeSchoolDistrict": {
                        "title": "Include school districts",
                        "type": "boolean",
                        "description": "Include school district results. Example: 'Los Angeles Unified School District'. Default is enabled.",
                        "default": true
                    },
                    "includeUniversity": {
                        "title": "Include universities",
                        "type": "boolean",
                        "description": "Include college and university results. Example: 'Stanford University, Stanford, CA'. Default is enabled.",
                        "default": true
                    },
                    "includePark": {
                        "title": "Include parks",
                        "type": "boolean",
                        "description": "Include parks and recreation areas. Example: 'Central Park, New York, NY'. Default is enabled.",
                        "default": true
                    },
                    "includeState": {
                        "title": "Include states",
                        "type": "boolean",
                        "description": "Include state-level results. Example: 'California'. Default is enabled.",
                        "default": true
                    },
                    "includeMlsId": {
                        "title": "Include MLS IDs",
                        "type": "boolean",
                        "description": "Include MLS listing ID matches. Example: 'OC22183456'. Default is enabled.",
                        "default": true
                    },
                    "timeoutSecs": {
                        "title": "Overall timeout (seconds)",
                        "minimum": 30,
                        "maximum": 3600,
                        "type": "integer",
                        "description": "Maximum runtime for the entire actor in seconds. The actor stops when this time is exceeded. Default is 300 (5 minutes). Example: 600 for larger batches.",
                        "default": 300
                    },
                    "requestTimeoutSecs": {
                        "title": "Per-request timeout (seconds)",
                        "minimum": 5,
                        "maximum": 120,
                        "type": "integer",
                        "description": "Maximum time to wait for the Realtor.com autocomplete server per query. Default is 30 seconds.",
                        "default": 30
                    },
                    "proxyConfiguration": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Proxy settings for requests. Default uses Apify datacenter proxies."
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
