# Trulia Scraper — US Listings, Neighborhood Intel & Comps (`sian.agency/trulia-property-scraper`) Actor Scrape Trulia US real estate — for-sale, for-rent and sold listings — by location, ZIP, coordinates or URL. Pull rich property detail with neighborhood amenities, schools, demographics, price history and comparable homes, plus built-in market KPIs and an HTML report. - **URL**: https://apify.com/sian.agency/trulia-property-scraper.md - **Developed by:** [SIÁN OÜ](https://apify.com/sian.agency) (community) - **Categories:** Automation, Lead generation, Real estate - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.50 / 1,000 property extracteds This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. 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 ## Trulia Scraper — US Listings, Neighborhood Intel & Comps 🏡 [![SIÁN Agency Store](https://img.shields.io/badge/Store-SI%C3%81N%20Agency-1AE392)](https://apify.com/sian.agency?fpr=sian) [![Redfin Property Scraper](https://img.shields.io/badge/Store-Redfin%20Property%20Scraper-A02021)](https://apify.com/sian.agency/redfin-property-scraper?fpr=sian) [![Realtor.com Scraper](https://img.shields.io/badge/Store-Realtor.com%20Scraper-D92228)](https://apify.com/sian.agency/realtor-property-scraper?fpr=sian) [![Zillow Agent Scraper](https://img.shields.io/badge/Store-Zillow%20Agent%20Scraper-1F4E79)](https://apify.com/sian.agency/zillow-agent-scraper?fpr=sian) #### 🎉 The only Trulia scraper that turns every property into a full neighborhood dossier — amenities, schools, demographics and comparable homes ##### Built for real estate investors, buyer's agents, relocation services and market analysts who need more than a listing card --- ### 📋 Overview **Pull rich US residential data from Trulia in one run** — for-sale, for-rent and recently-sold listings, plus the neighborhood intelligence most scrapers leave behind. Search a whole metro or drill into a single home; either way you get structured, analysis-ready data. **Why professionals choose this Trulia scraper:** - ✅ **Neighborhood intel built in**: every detail lookup returns nearby **amenities, schools (with ratings), demographics, neighborhood ratings, price history, taxes and HOA** — not just the listing card. - ⚡ **10 lookup modes, one actor**: search by location, ZIP, coordinates or URL; detail by listing ID, URL or address; nearby amenities; comparable homes; and location autocomplete. - 🎯 **For sale + for rent + sold**: one `searchType` switch covers active sales, rentals and recently-sold comps. - 💰 **Pay-per-result pricing**: only charged for rows that land in your dataset — cheaper than monthly flat-rate Trulia tools. - 💎 **Comparable homes (comps)**: instant comp set for any listing, ideal for valuation and offer prep. - ✨ **Built-in market KPIs + HTML report**: median price, price-per-sqft distribution and city / status / type breakdowns, every run. This is the third independent US listings source in the SIÁN real estate suite — pair it with the [Redfin](https://apify.com/sian.agency/redfin-property-scraper?fpr=sian) and [Realtor.com](https://apify.com/sian.agency/realtor-property-scraper?fpr=sian) scrapers to cross-validate prices, beds/baths and status across three sources. --- ### ✨ Features - 🔎 **Search by location**: city/state, neighborhood, ZIP or free text, fully paginated. - 🏷️ **Search by ZIP**: pull every listing in a 5-digit ZIP. - 🌐 **Search by coordinates**: lat/long + radius for map-bounded farming. - 🔗 **Search by URL**: paste any Trulia search page and collect the results. - 🆔 **Detail by ID / URL / address**: full property dossier from any identifier. - 📍 **Neighborhood amenities**: nearby restaurants, groceries, shopping, fitness and arts, categorized. - 🔁 **Comparable homes**: the `similar` set for any listing. - 🎓 **Schools + demographics**: assigned and nearby schools with ratings, plus area demographics. - 📈 **Price history, taxes & HOA**: the financial context behind each listing. - 📊 **Market KPIs + HTML report**: median price, price/sqft, and breakdowns every run. --- ### 🎬 Quick Start Pick an operation, give it a location (or a listing identifier), and run. Results stream to your Apify dataset as structured JSON. Start on the FREE tier to test, then scale. ```bash curl -X POST "https://api.apify.com/v2/acts/sian.agency~trulia-property-scraper/runs?token=YOUR_TOKEN" \ -H 'Content-Type: application/json' \ -d '{"operation": "searchByLocation", "location": "Austin, TX", "searchType": "FOR_SALE", "maxResults": 50}' ```` *** ### 🚀 Getting Started (3 Simple Steps) #### Step 1: Choose an operation Search a market (`searchByLocation` / `searchByZip` / `searchByCoordinates` / `searchByUrl`) or look up one home (`detailsById` / `detailsByUrl` / `detailsByAddress`), then enrich it with `amenities` or `similar`. #### Step 2: Provide the input A location string, ZIP, lat/long, Trulia URL, listing ID or address — whatever the operation needs. #### Step 3: Run and export Collect structured rows in the dataset and a market-KPI HTML report in the key-value store. Export to JSON, CSV or Excel. **That's it! In under a minute, you'll have:** - A clean dataset of Trulia listings (or a full property dossier) - Neighborhood amenities, schools and comparable homes - A market-KPI summary report *** ### 📥 Input Configuration | Field | Type | Required | Description | |-------|------|----------|-------------| | operation | string | Yes | Which lookup to run (see list below). Default `searchByLocation`. | | location | string | For location search | City/state, neighborhood, ZIP or free text, e.g. `Austin, TX`. | | zipCode | string | For ZIP search | 5-digit US ZIP, e.g. `78724`. | | latitude / longitude | string | For coordinate search / amenities | Center point. | | radius | string | No | Radius in miles for coordinate search. | | url | string | For URL / detail / similar / amenities | Trulia search or property URL, or a `/home/...` path. | | listingId | string | For detailsById | Trulia listing/property ID. | | address | string | For detailsByAddress | Trulia-indexed full address. | | searchType | string | No | `FOR_SALE` (default), `FOR_RENT` or `SOLD`. | | propertyType | string | No | Comma-separated, e.g. `house,condo` (location search). | | minPrice | string | No | Minimum price filter (location search). | | maxResults | integer | No | Max rows per run. FREE tier capped at 60. | **Operations:** `searchByLocation` · `searchByZip` · `searchByCoordinates` · `searchByUrl` · `detailsById` · `detailsByUrl` · `detailsByAddress` · `amenities` · `similar` · `autocomplete` **Example — search a metro:** ```json { "operation": "searchByLocation", "location": "Austin, TX", "searchType": "FOR_RENT", "maxResults": 100 } ``` **Example — full property dossier:** ```json { "operation": "detailsByUrl", "url": "/home/7708-dalmation-ln-557-austin-tx-78724-463215544" } ``` **Example — neighborhood amenities:** ```json { "operation": "amenities", "url": "/home/7708-dalmation-ln-557-austin-tx-78724-463215544", "maxResults": 50 } ``` *** ### 📤 Output Results are saved to the Apify dataset. Listing rows, detail rows, amenity rows and suggestion rows each carry a `rowType`. Key fields include: | Field | Type | Description | |-------|------|-------------| | rowType | string | property · property-detail · amenity · location-suggestion | | propertyId / listingId | string | Trulia identifiers | | url | string | Full Trulia listing URL | | status | string | For Sale / For Rent / Recently Sold / Off Market | | address | object | Street, city, county, state, ZIP, neighborhood | | location | object | Latitude / longitude | | pricing | object | Display price + numeric value + price change | | specs | object | Beds, baths, floor space | | media | object | Photos, photo count, floor plans | | propertyDescription | string | Listing description (detail rows) | | schools | object | Assigned + nearby schools with ratings (detail rows) | | demographics | object | Area demographics (detail rows) | | neighborhood | object | Neighborhood name + ratings (detail rows) | | priceHistory | array | Listing / sale / price-change events (detail rows) | | taxes / hoaFee | object | Tax assessment + HOA fee (detail rows) | | name / category / subcategory / rating | – | Nearby amenity fields (amenity rows) | **Example — listing row:** ```json { "rowType": "property", "propertyId": "463215544_ZPID", "listingId": "7463215544", "url": "https://www.trulia.com/home/7708-dalmation-ln-557-austin-tx-78724-463215544", "status": "For Sale", "address": { "city": "Austin", "state": "TX", "zipCode": "78724", "full": "7708 Dalmation Ln #557, Austin, TX 78724" }, "location": { "latitude": 30.3171, "longitude": -97.6247 }, "pricing": { "price": "$129,995" }, "specs": { "beds": "5bd", "baths": "3ba", "floorSpace": "2,128 sqft" } } ``` A market-KPI HTML report (median price, price/sqft, breakdowns) is saved to the key-value store as `report.html`. *** ### 💼 Use Cases & Examples #### 1. Real estate investors **Find and value distressed and below-market homes across a metro.** **Input:** `searchByLocation` + `SOLD` for comps, then `similar` on a target. **Output:** Recently-sold prices, price/sqft and a comparable set. **Use:** Underwrite offers with three independent sources (Trulia + Redfin + Realtor). #### 2. Buyer's agents **Build neighborhood-rich listing packets for clients.** **Input:** `detailsByUrl` then `amenities`. **Output:** Schools, demographics, nearby amenities and price history in one packet. **Use:** Win listings with data competitors don't surface. #### 3. Relocation services **Compare neighborhoods for relocating employees.** **Input:** `amenities` + `searchByZip` across candidate ZIPs. **Output:** Amenity density, school ratings and price bands per area. **Use:** Match families to the right neighborhood, fast. #### 4. Market analysts **Track for-sale, for-rent and sold inventory by metro.** **Input:** `searchByLocation` with each `searchType`. **Output:** Median price, price/sqft and city/type breakdowns from the built-in KPIs. **Use:** Feed dashboards and market reports. #### 5. Lead generation **Surface new and price-reduced listings for outreach.** **Input:** `searchByLocation` sorted by newest, filtered by `propertyType` and `minPrice`. **Output:** Fresh listings with address, price and status. **Use:** Prioritize outreach to motivated sellers and renters. *** ### 🔗 Integration Examples #### JavaScript/Node.js ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'YOUR_TOKEN' }); const run = await client.actor('sian.agency/trulia-property-scraper').call({ operation: 'searchByLocation', location: 'Austin, TX', searchType: 'FOR_SALE', maxResults: 50 }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items[0]); ``` #### Python ```python from apify_client import ApifyClient client = ApifyClient('YOUR_TOKEN') run = client.actor('sian.agency/trulia-property-scraper').call( run_input={'operation': 'detailsByUrl', 'url': '/home/7708-dalmation-ln-557-austin-tx-78724-463215544'} ) for item in client.dataset(run['defaultDatasetId']).iterate_items(): print(item) ``` #### cURL ```bash curl -X POST 'https://api.apify.com/v2/acts/sian.agency~trulia-property-scraper/runs?token=YOUR_TOKEN' \ -H 'Content-Type: application/json' \ -d '{"operation": "searchByZip", "zipCode": "78724"}' ``` #### Automation Workflows (N8N / Zapier / Make) 1. **Trigger**: Schedule or webhook 2. **HTTP Request**: Call the actor API 3. **Process**: Handle the JSON results 4. **Action**: Save to a sheet, CRM or database *** ### 📊 Performance & Pricing #### FREE Tier (Try It Now) - Up to **60 rows** per run — full feature access, same data quality - No credit card required - Perfect for testing a market or a single property #### PAID Tier (Production Ready) - **Unlimited** rows per run, deep pagination - Pay-per-result: only charged for rows written to your dataset 💰 **Transparent pay-per-result pricing** — search listings, neighborhood amenities and enriched property dossiers are each billed per row, so you only pay for the data you keep. 🔗 [View current pricing](https://apify.com/sian.agency/trulia-property-scraper?fpr=sian) *** ### ❓ Frequently Asked Questions **Q: How many listings can I collect?** A: FREE tier: up to 60 rows per run. PAID tier: unlimited with deep pagination. **Q: Can I get for-rent and sold listings, not just for-sale?** A: Yes — set `searchType` to `FOR_RENT` or `SOLD`. **Q: What's in the enriched property detail?** A: Neighborhood, schools (with ratings), demographics, price history, taxes, HOA, photos and the full description. **Q: What output formats are available?** A: JSON, CSV and Excel — export directly from the Apify dataset. **Q: Does it work with any US address?** A: `detailsByAddress` works for Trulia-indexed addresses; for the best hit rate use a full formatted address or use `detailsByUrl` / `detailsById`. **Q: Is this legal?** A: Yes — it only extracts publicly available data. See the legal section below. *** ### 🐛 Troubleshooting **No detail returned for an address** - Use a full, Trulia-indexed address (street, city, state, ZIP) or switch to `detailsByUrl` / `detailsById`. **Empty search results** - Broaden the location, remove `propertyType` / `minPrice` filters, or try a different `searchType`. **Hitting the FREE-tier row cap** - FREE runs are capped at 60 rows. Upgrade your Apify plan for unlimited rows and deep pagination. **Coordinate search returns nothing** - Confirm latitude is between -90 and 90 and longitude between -180 and 180, and increase `radius`. *** ### ⚠️ Trademark Disclaimer This is an independent tool and is **not affiliated with, endorsed by, or sponsored by Trulia or Zillow Group, Inc.** "Trulia" is a trademark of its respective owner. This actor accesses only publicly available information and is intended for legitimate data-analysis purposes. All product names, trademarks and registered trademarks are the property of their respective owners and are used for identification purposes only. *** ### ⚖️ Is it legal to scrape data? Our actors are ethical and do not extract any private user data, such as email addresses, gender, or location. They only extract what the user has chosen to share publicly. We therefore believe that our actors, when used for ethical purposes by Apify users, are safe. However, you should be aware that your results could contain personal data. Personal data is protected by the **GDPR** in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers. You can also read Apify's blog post on the [legality of web scraping](https://blog.apify.com/is-web-scraping-legal/). *** ### 🤝 Support [![Telegram Support](https://img.shields.io/badge/Telegram-Support%20Group-0088cc?logo=telegram)](https://t.me/+vyh1sRE08sAxMGRi) **Join our active support community** - For issues or questions, open an issue in the actor's Issues tab - Check the [SIÁN Agency Store](https://apify.com/sian.agency?fpr=sian) for more automation tools - 📧 *** **Built by [SIÁN Agency](https://www.sian-agency.online)** | **[More Tools](https://apify.com/sian.agency?fpr=sian)** # Actor input Schema ## `operation` (type: `string`): What to pull from Trulia. **Search (listing rows):** • **searchByLocation** — city / state / neighborhood / ZIP / free text (paginated) • **searchByZip** — exact 5-digit ZIP • **searchByCoordinates** — lat/long + radius • **searchByUrl** — paste a Trulia search URL **Detail (single rich listing):** • **detailsById** / **detailsByUrl** / **detailsByAddress** — full detail with neighborhood, schools, demographics, price history, taxes & photos **Neighborhood + comps:** • **amenities** — nearby restaurants, groceries, shopping, fitness & arts • **similar** — comparable homes for a listing **Helper:** • **autocomplete** — resolve a location string ## `location` (type: `string`): For **searchByLocation** — a city/state, neighborhood, ZIP or free text, e.g. `Austin, TX`, `78704`, `Brooklyn, NY`. ## `zipCode` (type: `string`): For **searchByZip** — a 5-digit US ZIP, e.g. `78724`. ## `latitude` (type: `string`): For **searchByCoordinates** / **amenities** — center latitude, e.g. `30.2672`. ## `longitude` (type: `string`): For **searchByCoordinates** / **amenities** — center longitude, e.g. `-97.7431`. ## `radius` (type: `string`): For **searchByCoordinates** — search radius in miles around the point (default 10). ## `url` (type: `string`): For **searchByUrl / detailsByUrl / similar / amenities** — a Trulia search page (e.g. `https://www.trulia.com/for_sale/Austin,TX/`) or a property page / `/home/...` path (e.g. `/home/7708-dalmation-ln-557-austin-tx-78724-463215544`). ## `listingId` (type: `string`): For **detailsById** — the listing ID from a Trulia card or URL, e.g. `7463215544` or `463215544`. ## `address` (type: `string`): For **detailsByAddress** — a Trulia-indexed full address, e.g. `7708 Dalmation Ln #557, Austin, TX 78724`. ## `searchType` (type: `string`): For search / similar / autocomplete — which listings to return. ## `propertyType` (type: `string`): For **searchByLocation** — comma-separated property types to filter, e.g. `house,condo`. Leave empty for any. ## `minPrice` (type: `string`): For **searchByLocation** — minimum price filter. ## `maxResults` (type: `integer`): Maximum rows to collect for paginated / list operations (also caps amenities). FREE tier is capped at 60. ## Actor input object example ```json { "operation": "searchByLocation", "location": "Austin, TX", "searchType": "FOR_SALE", "maxResults": 50 } ``` # Actor output Schema ## `results` (type: `string`): Trulia listings, enriched detail rows, neighborhood amenities and comparable-home rows. ## `htmlReport` (type: `string`): HTML summary with run stats and market KPIs (median price, price/sqft distribution, listing-type / status / city breakdowns). # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "location": "Austin, TX" }; // Run the Actor and wait for it to finish const run = await client.actor("sian.agency/trulia-property-scraper").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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "location": "Austin, TX" } # Run the Actor and wait for it to finish run = client.actor("sian.agency/trulia-property-scraper").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 '{ "location": "Austin, TX" }' | apify call sian.agency/trulia-property-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=sian.agency/trulia-property-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Trulia Scraper — US Listings, Neighborhood Intel & Comps", "description": "Scrape Trulia US real estate — for-sale, for-rent and sold listings — by location, ZIP, coordinates or URL. Pull rich property detail with neighborhood amenities, schools, demographics, price history and comparable homes, plus built-in market KPIs and an HTML report.", "version": "1.0", "x-build-id": "24yg1BKM3ESfJQhvG" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sian.agency~trulia-property-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sian.agency-trulia-property-scraper", "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/sian.agency~trulia-property-scraper/runs": { "post": { "operationId": "runs-sync-sian.agency-trulia-property-scraper", "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/sian.agency~trulia-property-scraper/run-sync": { "post": { "operationId": "run-sync-sian.agency-trulia-property-scraper", "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", "properties": { "operation": { "title": "🧭 Operation", "enum": [ "searchByLocation", "searchByZip", "searchByCoordinates", "searchByUrl", "detailsById", "detailsByUrl", "detailsByAddress", "amenities", "similar", "autocomplete" ], "type": "string", "description": "What to pull from Trulia.\n\n**Search (listing rows):**\n• **searchByLocation** — city / state / neighborhood / ZIP / free text (paginated)\n• **searchByZip** — exact 5-digit ZIP\n• **searchByCoordinates** — lat/long + radius\n• **searchByUrl** — paste a Trulia search URL\n\n**Detail (single rich listing):**\n• **detailsById** / **detailsByUrl** / **detailsByAddress** — full detail with neighborhood, schools, demographics, price history, taxes & photos\n\n**Neighborhood + comps:**\n• **amenities** — nearby restaurants, groceries, shopping, fitness & arts\n• **similar** — comparable homes for a listing\n\n**Helper:**\n• **autocomplete** — resolve a location string", "default": "searchByLocation" }, "location": { "title": "📍 Location", "type": "string", "description": "For **searchByLocation** — a city/state, neighborhood, ZIP or free text, e.g. `Austin, TX`, `78704`, `Brooklyn, NY`." }, "zipCode": { "title": "🏷️ ZIP Code", "type": "string", "description": "For **searchByZip** — a 5-digit US ZIP, e.g. `78724`." }, "latitude": { "title": "🌐 Latitude", "type": "string", "description": "For **searchByCoordinates** / **amenities** — center latitude, e.g. `30.2672`." }, "longitude": { "title": "🌐 Longitude", "type": "string", "description": "For **searchByCoordinates** / **amenities** — center longitude, e.g. `-97.7431`." }, "radius": { "title": "📏 Radius (miles)", "type": "string", "description": "For **searchByCoordinates** — search radius in miles around the point (default 10)." }, "url": { "title": "🔗 Trulia URL", "type": "string", "description": "For **searchByUrl / detailsByUrl / similar / amenities** — a Trulia search page (e.g. `https://www.trulia.com/for_sale/Austin,TX/`) or a property page / `/home/...` path (e.g. `/home/7708-dalmation-ln-557-austin-tx-78724-463215544`)." }, "listingId": { "title": "🆔 Listing ID", "type": "string", "description": "For **detailsById** — the listing ID from a Trulia card or URL, e.g. `7463215544` or `463215544`." }, "address": { "title": "🏠 Address", "type": "string", "description": "For **detailsByAddress** — a Trulia-indexed full address, e.g. `7708 Dalmation Ln #557, Austin, TX 78724`." }, "searchType": { "title": "🔖 Listing Type", "enum": [ "FOR_SALE", "FOR_RENT", "SOLD" ], "type": "string", "description": "For search / similar / autocomplete — which listings to return.", "default": "FOR_SALE" }, "propertyType": { "title": "🏘️ Property Type", "type": "string", "description": "For **searchByLocation** — comma-separated property types to filter, e.g. `house,condo`. Leave empty for any." }, "minPrice": { "title": "💵 Min Price", "type": "string", "description": "For **searchByLocation** — minimum price filter." }, "maxResults": { "title": "🔢 Max results", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum rows to collect for paginated / list operations (also caps amenities). FREE tier is capped at 60.", "default": 50 } } }, "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 } } } } } } } } } } ```