# Realtor Real Estate Listings (`truefetch/realtor-real-estate-listings`) Actor Search Realtor.com real estate listings in the United States. Collect for-sale, rental, and sold property data with prices, MLS details, beds, baths, images, agents, and source URLs. - **URL**: https://apify.com/truefetch/realtor-real-estate-listings.md - **Developed by:** [TrueFetch](https://apify.com/truefetch) (community) - **Categories:** Real estate, Lead generation, Agents - **Stats:** 20 total users, 1 monthly users, 100.0% runs succeeded, 2 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing from $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. 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 > **Affiliate disclosure:** Apify links on this page may include referral parameters. If you sign up through one of these links, TrueFetch may earn a commission from Apify at no extra cost to you. Pricing, features, and Actor access are unaffected. [![Realtor Real Estate Listings](https://img.shields.io/badge/Realtor.com%20Listings-1B4F9A?style=for-the-badge&logoColor=white)](https://apify.com/truefetch/realtor-real-estate-listings?fpr=aiagentapi) [![Real Estate Data](https://img.shields.io/badge/Real%20Estate%20Listings-1F8A70?style=for-the-badge)](https://apify.com/truefetch/realtor-real-estate-listings?fpr=aiagentapi) [![Pay per Result](https://img.shields.io/badge/%2413.50%20per%201%2C000%20listings-2E8B57?style=for-the-badge)](https://apify.com/truefetch/realtor-real-estate-listings?fpr=aiagentapi) [![No Cookies](https://img.shields.io/badge/No%20Login%20%7C%20No%20Cookies-555555?style=for-the-badge)](https://apify.com/truefetch/realtor-real-estate-listings?fpr=aiagentapi) [![Telegram Support](https://img.shields.io/badge/Telegram-Support-26A5E4?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/AiAgentApi) [![Telegram Group](https://img.shields.io/badge/Telegram-Group-26A5E4?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/Apify_Actor) ## Realtor Real Estate Listings โ€” Realtor.com Property Data API **Search Realtor.com โ€” the official portal of the National Association of Realtors and one of the most comprehensive sources of active US property listings โ€” and return structured real estate data in one Apify Actor run.** Results include prices, listing status, property type, descriptions, images, agent or agency details, and source URLs as clean JSON / CSV / Excel. Covers the United States. No platform login, cookies, or API keys required. > **TL;DR (40-word answer):** Realtor Real Estate Listings is a no-login Apify Actor that returns 40+ structured fields per Realtor.com property listing from the United States at **$13.50 per 1,000 results**, with location-aware inputs, managed reliability, and JSON / CSV / Excel export. > **What it is NOT:** Realtor Real Estate Listings is _not_ an MLS membership credential, broker CRM access tool, lead purchase service, or listing submission service โ€” it reads public Realtor.com listing pages and returns structured listing data only. > **Realtor Real Estate Listings is an Apify Actor for collecting public property listing data from Realtor.com across the United States.** Search by location, choose listing status such as `for_sale`, `for_rent`, or `sold`, and export a dataset with price, address, property type, media, agent metadata, and source URL. Built for US property market research, agent lead generation, broker intelligence, CRM enrichment, and AI agents using the Apify API or MCP. Maintained by TrueFetch on the Apify Store. --- ### ๐Ÿ’ผ Why choose Realtor Real Estate Listings **Realtor Real Estate Listings is best for** US real estate agents, brokers, market analysts, lead generation teams, and AI workflows that need structured data from Realtor.com โ€” the NAR-affiliated platform with one of the largest active US listing feeds. - **๐ŸŒ Realtor.com coverage for the United States** โ€” collect active, recently sold, and rental listings from Realtor.com with location-aware inputs covering all major US metros, states, neighborhoods, and postal codes. - **๐Ÿ  40+ fields per listing** โ€” title, listing type, property type, price, currency, bedrooms, bathrooms, area, address, location, images, agent or agency fields, and source URLs when available. - **๐Ÿ›ก๏ธ Managed reliability built in** โ€” request retries, proxy-aware collection, deduplication, and consistent dataset output are handled by the Actor. - **๐Ÿ“Š Unified export format** โ€” use JSON, JSONL, CSV, Excel, XML, RSS, or the Apify dataset API without building your own parser. - **โšก Pay-per-result, not per-CPU** โ€” flat **$13.50 per 1,000 successful listings** (`$0.0135` per result). Free Apify plan includes $5 monthly credits โ‰ˆ **~370 free listings per month**. --- ### ๐Ÿš€ Quick Start โ€” run in 3 steps #### Run in Apify Console 1. **Open the Actor** โ€” go to [Realtor Real Estate Listings on Apify](https://apify.com/truefetch/realtor-real-estate-listings?fpr=aiagentapi) and click **Try for free**. 2. **Configure inputs** โ€” choose a `country`, enter a `location`, set `listing_type`, and choose `max_results`. 3. **Click Start** โ€” the Actor streams real estate listings to the dataset. Export as JSON, JSONL, CSV, Excel, XML, RSS, or pull via the dataset API. #### Run via Apify API ```bash curl -X POST "https://api.apify.com/v2/acts/TrueFetch~realtor-real-estate-listings/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "country": "United States", "location": "Austin, TX", "listing_type": "for_sale", "max_results": 100 }' ```` #### Run via MCP (for AI agents) Realtor Real Estate Listings is callable from Claude, ChatGPT, Cursor, and any MCP-compatible client through the [Apify MCP Server](https://docs.apify.com/platform/integrations/mcp?fpr=aiagentapi). Reference the Actor as `TrueFetch/realtor-real-estate-listings` and pass the same JSON input as above. *** ### โš™๏ธ Input parameters | Parameter | Type | Required | Default | Description | Example | | --------------- | ------- | :------: | ---------- | ----------------------------------------------------------------------------------------- | --------------- | | `country` | string | โœ… | โ€” | Supported Realtor.com market. United States is supported. | `United States` | | `location` | string | โœ… | โ€” | City, region, neighborhood, postal code, or address to search. | `Austin, TX` | | `max_results` | integer | โœ… | โ€” | Maximum number of real estate listings to return. Each successful listing is billed once. | `100` | | `listing_type` | string | โŒ | `for_sale` | Listing status such as `for_sale`, `for_rent`, or `sold` where supported. | `for_sale` | | `property_type` | string | โŒ | empty | Optional property type filter. Leave empty to include all supported property types. | `house` | **Default behavior:** the Actor queries the supported source for the selected country and location, deduplicates by source URL or listing ID, and streams results to the default dataset. ```json { "country": "United States", "location": "Austin, TX", "listing_type": "for_sale", "max_results": 100 } ``` *** ### ๐Ÿ“ฆ Output dataset Each run writes structured real estate objects to the **default Apify dataset**, exportable as JSON, JSONL, CSV, Excel, XML, RSS, or via the dataset API. | Field | Type | Always present? | Description | Example | | --------------- | ------ | :-------------: | ------------------------------------------------------------- | ----------------------------------------------------- | | `platform` | string | โœ… | Source platform name. | `Realtor.com` | | `source_url` | string | โœ… | Original listing URL for verification. | `https://example.com/listing/123` | | `title` | string | โœ… | Listing title. | `Modern 2 bedroom apartment` | | `description` | string | optional | Clean listing description when available. | `Bright apartment near transit with updated kitchen.` | | `listing_id` | string | optional | Platform listing identifier. | `123456789` | | `listing_type` | string | optional | `for_sale`, `for_rent`, or `sold`. | `for_sale` | | `property_type` | string | optional | House, apartment, condo, land, commercial, or similar. | `house` | | `price` | object | optional | Price value, text, and currency when available. | `{"value": 750000, "currency": "USD"}` | | `beds` | number | optional | Bedroom count. | `3` | | `baths` | number | optional | Bathroom count. | `2` | | `area` | object | optional | Floor area or lot area with unit. | `{"value": 1450, "unit": "sqft"}` | | `address` | object | optional | Structured address fields when available. | `{"city": "Denver", "region": "CO"}` | | `location` | string | optional | Human-readable location. | `Austin, TX` | | `geo` | object | optional | Latitude and longitude when available. | `{"lat": 39.7392, "lon": -104.9903}` | | `image_urls` | array | optional | Deduplicated listing image URLs. | `["https://images.example.com/1.jpg"]` | | `agent` | object | optional | Agent, agency, phone, email, or profile data when available. | `{"name": "Jane Agent"}` | | `official_url` | string | optional | Official outbound URL when explicitly provided by the source. | `https://agency.example.com/listing/123` | #### Sample output ```json { "platform": "Realtor.com", "source_url": "https://example.com/listing/123", "title": "Modern 2 bedroom apartment", "listing_type": "for_sale", "property_type": "apartment", "price": { "value": 750000, "currency": "USD", "text": "$750,000" }, "beds": 2, "baths": 2, "location": "Austin, TX", "image_urls": ["https://images.example.com/property.jpg"] } ``` *** ### ๐Ÿ’ก Use cases #### For real estate investors and analysts Track active, recently sold, or for-rent Realtor.com listings in target US locations, compare broker-listed asking prices, monitor inventory in specific neighborhoods, and export clean datasets for US market trend analysis. #### For agencies and lead generation teams Collect Realtor.com listing metadata, agent or agency fields where available, source URLs, and location details to build lead prospecting lists, agent directories, and CRM enrichment pipelines. #### For property portals and data products Use scheduled runs to refresh your US listing feed with Realtor.com data. Deduplicate on `source_url` or `listing_id`, then push to your database or downstream data product. #### For AI agents and research assistants Call this Actor through the Apify API or MCP server to answer US property market questions โ€” active inventory, pricing by metro, listing volume โ€” with live Realtor.com data instead of stale training data. *** ### ๐Ÿ’ฐ Pricing, limits, and performance | Fact | Value | | --------------------------- | ------------------------------------------------- | | Pricing model | Pay-per-result (event: `result`) | | Per-result price | **$0.0135 per listing = $13.50 per 1,000** | | Free-tier monthly allowance | $5 Apify credits โ‰ˆ **~370 free listings / month** | | Supported source | Realtor.com | | Supported markets | the United States | | Output fields per listing | **40+** | | Login / cookies required | **No** โ€” works without a platform account | | Export formats | JSON, JSONL, CSV, Excel, XML, RSS, dataset API | You are billed only for **successfully delivered, deduplicated real estate listings**. Blocked requests, retries, and duplicates are not billed as result events. *** ### โš–๏ธ Compared with alternatives | Capability | **Realtor Real Estate Listings** | Manual browsing | In-house scraper | | ----------------------------- | :------------------------------: | :-------------: | :------------------: | | Structured listing dataset | โœ… | โŒ | you build | | No platform login required | โœ… | varies | varies | | JSON / CSV / Excel export | โœ… | โŒ | you build | | Managed retries and stability | โœ… | โŒ | you maintain | | Source URL for verification | โœ… | manual | you build | | Pay-per-result pricing | โœ… | time cost | infrastructure + dev | | Setup time to first result | < 60 seconds | manual | days to weeks | **Verdict.** Use Realtor Real Estate Listings when you need structured real estate listing data without building and maintaining platform-specific scraping infrastructure. *** ### โš ๏ธ Common mistakes to avoid 1. **Using a vague location.** Prefer city, postal code, neighborhood, or address formats supported by the selected platform. 2. **Expecting every field on every listing.** Some platforms or sellers do not publish agent, area, geo, or fee fields. 3. **Setting `max_results` too high for narrow searches.** A small neighborhood may not have enough matching listings. 4. **Confusing missing fields with parser failure.** If the raw source does not publish a field, the output should stay empty rather than invent a value. 5. **Ignoring source URLs.** Always keep `source_url` for verification and downstream deduplication. *** ### ๐Ÿ› ๏ธ Troubleshooting | Problem | Likely cause | Fix | | ------------------------------------- | ------------------------------------------------------ | ----------------------------------------------------------------- | | Fewer results than `max_results` | The source has fewer matching listings. | Try a broader location, different listing type, or larger market. | | Run returns 0 results | Location or listing type is too narrow or unsupported. | Try a major city, postal code, or a supported listing type. | | Some prices or agent fields are empty | The source listing did not publish those fields. | Treat empty values as expected and filter downstream if needed. | | Results look unrelated | Location format may not match the platform's routing. | Use city/state, postal code, or a more precise address. | | Charge limit reached | Account-level run or monthly spend limit hit. | Raise the run or monthly limit in your Apify settings. | *** ### โ“ FAQ #### What data does Realtor Real Estate Listings return? It returns structured Realtor.com listing data including platform, source URL, title, description, listing type, property type, price, bedrooms, bathrooms, floor area, address, location, geo coordinates, images, and agent or agency details when published on Realtor.com. #### How much does Realtor Real Estate Listings cost? Realtor Real Estate Listings uses pay-per-result pricing at **$0.0135 per listing**, or **$13.50 per 1,000 listings**. The Apify Free plan includes $5 of monthly platform credits, covering approximately **370 free listings per month**. #### Does Realtor Real Estate Listings require a login or cookies? No. The Actor reads public Realtor.com listing pages without a Realtor.com account, cookies, or source-site API key. You only need an Apify token to invoke the Actor programmatically. #### Can I export results to CSV or Excel? Yes. Apify datasets can be exported as JSON, JSONL, CSV, Excel, XML, RSS, or consumed through the dataset API. #### Is this MLS data? Realtor.com aggregates listings from participating MLS feeds and publishes them publicly. This Actor collects data from public Realtor.com listing pages and does not provide direct MLS access, IDX credentials, or RETS feed connections. *** ### ๐Ÿ”Œ Integrations Use Realtor Real Estate Listings with: - **Apify API** for backend ingestion. - **MCP clients** such as Claude, ChatGPT, Cursor, and other AI tools through Apify MCP Server. - **Make, n8n, Zapier, and webhooks** for no-code workflows. - **CSV / Excel exports** for analysts and operations teams. - **Data warehouses** such as BigQuery, Snowflake, Postgres, and internal BI systems. *** ### ๐Ÿงฑ Sister Actors from TrueFetch #### Jobs - [Best Job Listing](https://apify.com/truefetch/best-job-listing?fpr=aiagentapi) - [Indeed Job Listing](https://apify.com/truefetch/indeed-job-listing?fpr=aiagentapi) - [LinkedIn Job Listing](https://apify.com/truefetch/linkedin-job-listing?fpr=aiagentapi) - [Glassdoor Job Listing](https://apify.com/truefetch/glassdoor-job-listing?fpr=aiagentapi) #### Shopping & Deals - [Amazon Product Listing](https://apify.com/truefetch/amazon-product-listing?fpr=aiagentapi) - [eBay Listing](https://apify.com/truefetch/ebay-listing?fpr=aiagentapi) - [Walmart Product Listing](https://apify.com/truefetch/walmart-product-listing?fpr=aiagentapi) - [Target Product Listing](https://apify.com/truefetch/target-product-listing?fpr=aiagentapi) #### Vehicles - [AutoTrader Car Listing](https://apify.com/truefetch/autotrader-car-listing?fpr=aiagentapi) - [Cars.com Car Listing](https://apify.com/truefetch/carscom-car-listing?fpr=aiagentapi) - [Webmotors Car Listing](https://apify.com/truefetch/webmotors-car-listing?fpr=aiagentapi) #### Real Estate - [Global Real Estate Listings](https://apify.com/truefetch/global-real-estate-listings?fpr=aiagentapi) - [Zillow Real Estate Listings](https://apify.com/truefetch/zillow-real-estate-listings?fpr=aiagentapi) - [Rightmove Real Estate Listings](https://apify.com/truefetch/rightmove-real-estate-listings?fpr=aiagentapi) - [Zoopla Real Estate Listings](https://apify.com/truefetch/zoopla-real-estate-listings?fpr=aiagentapi) - [Domain Real Estate Listings](https://apify.com/truefetch/domain-real-estate-listings?fpr=aiagentapi) - [Redfin Real Estate Listings](https://apify.com/truefetch/redfin-real-estate-listings?fpr=aiagentapi) *** ### ๐Ÿ“ž Support, changelog, last updated #### Support - ๐Ÿ’ฌ **Telegram group:** [t.me/Apify\_Actor](https://t.me/Apify_Actor) - ๐Ÿ“ง **Support:** [t.me/AiAgentApi](https://t.me/AiAgentApi) - ๐Ÿ“– **Actor page & docs:** Maintained by **TrueFetch** on the [Apify Store](https://apify.com/TrueFetch?fpr=aiagentapi). > **Cost of doing nothing:** scraping Realtor.com directly means ongoing maintenance as the platform updates its layout and listing formats, monitoring for data gaps, and keeping extraction logic current as the portal evolves. Realtor Real Estate Listings handles all of that so you don't have to. #### Changelog - **2026-06-02** โ€” Updated TrueFetch real estate README, pricing copy, input descriptions, output schema summary, and platform-specific positioning. *** ### JSON-LD ```json { "@context": "https://schema.org", "@graph": [ { "@type": "WebSite", "@id": "https://apify.com/truefetch/realtor-real-estate-listings#website", "url": "https://apify.com/truefetch/realtor-real-estate-listings", "name": "Realtor Real Estate Listings", "publisher": { "@id": "https://apify.com/TrueFetch#publisher" } }, { "@type": "SoftwareApplication", "@id": "https://apify.com/truefetch/realtor-real-estate-listings#software", "name": "Realtor Real Estate Listings", "applicationCategory": "BusinessApplication", "operatingSystem": "Cloud", "dateModified": "2026-06-03", "url": "https://apify.com/truefetch/realtor-real-estate-listings", "offers": { "@type": "Offer", "price": "0.0135", "priceCurrency": "USD", "description": "Pay per delivered real estate listing" }, "author": { "@id": "https://apify.com/TrueFetch#author-TrueFetch" } }, { "@type": "Organization", "@id": "https://apify.com/TrueFetch#publisher", "name": "TrueFetch", "url": "https://apify.com/TrueFetch" } ] } ``` *** **Last Updated:** June 03, 2026 **Maintained by:** [TrueFetch](https://apify.com/TrueFetch?fpr=aiagentapi) ยท ๐Ÿ’ฌ [Telegram Group](https://t.me/Apify_Actor) ยท ๐Ÿ“ง [Support](https://t.me/AiAgentApi) # Actor input Schema ## `country` (type: `string`): Country where the target real estate listings are located ## `location` (type: `string`): City, region, neighborhood, postal code, or address to search ## `max_results` (type: `integer`): Maximum number of real estate listings to return per platform ## `listing_type` (type: `string`): Listing status to search: for sale, for rent, or sold where supported ## `property_type` (type: `string`): Optional property type filter. Leave empty to include all supported property types ## Actor input object example ```json { "country": "United States", "location": "Austin, TX", "max_results": 10, "listing_type": "for_sale" } ``` # Actor output Schema ## `results` (type: `string`): All property listings found across platforms with structured listing details and source URLs. # 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 = { "country": "United States", "location": "Austin, TX", "max_results": 10, "listing_type": "for_sale", "property_type": "" }; // Run the Actor and wait for it to finish const run = await client.actor("truefetch/realtor-real-estate-listings").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 = { "country": "United States", "location": "Austin, TX", "max_results": 10, "listing_type": "for_sale", "property_type": "", } # Run the Actor and wait for it to finish run = client.actor("truefetch/realtor-real-estate-listings").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 '{ "country": "United States", "location": "Austin, TX", "max_results": 10, "listing_type": "for_sale", "property_type": "" }' | apify call truefetch/realtor-real-estate-listings --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=truefetch/realtor-real-estate-listings", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Realtor Real Estate Listings", "description": "Search Realtor.com real estate listings in the United States. Collect for-sale, rental, and sold property data with prices, MLS details, beds, baths, images, agents, and source URLs.", "version": "1.0", "x-build-id": "zDr4zK5l1ddzhvJrw" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/truefetch~realtor-real-estate-listings/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-truefetch-realtor-real-estate-listings", "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/truefetch~realtor-real-estate-listings/runs": { "post": { "operationId": "runs-sync-truefetch-realtor-real-estate-listings", "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/truefetch~realtor-real-estate-listings/run-sync": { "post": { "operationId": "run-sync-truefetch-realtor-real-estate-listings", "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": [ "country", "location", "max_results" ], "properties": { "country": { "title": "Country", "enum": [ "United States" ], "type": "string", "description": "Country where the target real estate listings are located" }, "location": { "title": "Location", "type": "string", "description": "City, region, neighborhood, postal code, or address to search" }, "max_results": { "title": "Max Results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of real estate listings to return per platform" }, "listing_type": { "title": "Listing Type", "enum": [ "for_sale", "for_rent", "sold" ], "type": "string", "description": "Listing status to search: for sale, for rent, or sold where supported" }, "property_type": { "title": "Property Type", "enum": [ "residential", "house", "apartment", "condo", "townhouse", "land", "commercial", "new_development", "room", "student_housing", "senior_housing", "auction", "ready_to_build", "other" ], "type": "string", "description": "Optional property type filter. Leave empty to include all supported property types" } } }, "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 } } } } } } } } } } ```