# Realtor.ca Scraper (`one-api/realtorca-scraper`) Actor

Scrape Realtor.ca (Canada national MLS) — full property details, search listings by location/postal code/coordinates/polygon/URL, agent profiles, and search-box autocomplete. Backed by realtyapi.io real-time API.

- **URL**: https://apify.com/one-api/realtorca-scraper.md
- **Developed by:** [ONE API](https://apify.com/one-api) (community)
- **Categories:** Real estate, Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

$3.00 / 1,000 listing returneds

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.ca Scraper

Scrape **Realtor.ca** (Canada's national MLS listings site) — full property details, search listings, agent profiles, and search-box autocomplete — all from one Actor. Backed by [realtyapi.io](https://realtyapi.io)'s real-time Realtor.ca API.

⭐️ Found this useful? Please leave 5 stars! Issues / requests: 📬 **support@realtyapi.io**

---

### What you can do

| Section | What it does | Input format |
|---|---|---|
| 🏠 **Property Details** | Full details for a specific listing | Realtor.ca `property_id` digits, listing URL, or full street address — auto-detected per row |
| 🔎 **Search Listings** | Paginated search with filters | location string, Canadian postal code, `lat,lng,radius_mi`, polygon (`lon lat,lon lat,...`), or Realtor.ca search URL |
| 🔍 **Autocomplete** | Search-box suggestions (cities, postal codes, MLS, addresses) | partial query string |
| 👤 **Agent Search** | Find agents by name or location | free-text query |
| 👤 **Agent Details** | Full agent profile (bio, specialties, areas served, listings) | `agentId` from any agent search row |

You can fill any combination of sections in a single run — leave the others empty.

---

### Output

Each listing / property / agent / autocomplete suggestion is pushed as **one dataset row**, flattened to friendly columns plus a `Raw` column with the original JSON.

| Mode | Input Given | Property ID | MLS Number | Price | Beds | Baths | Address | Province | Postal Code | Agent Name | Organization Name | Listing URL | Raw |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| `search/bylocation` | Toronto, Ontario (p1) | 29729754 | W13108736 | $529,999 | 2 | 2 | 1811 - 30 ELM DRIVE W\|Mississauga (Fairview), Ontario L5B0N6 | Ontario | L5B0N6 | Jane Smith | Royal LePage | https://www.realtor.ca/... | `{...}` |
| `details/byid` | 29729754 | 29729754 | W13108736 | $529,999 | 2 | 2 | 1811 - 30 ELM DRIVE W\|Mississauga | Ontario | L5B0N6 | Jane Smith | Royal LePage | https://www.realtor.ca/... | `{...}` |

Plus: `Price Raw` (numeric), `Half Baths`, `Size Interior`, `Land Size`, `Property Type`, `Ownership Type`, `Transaction Type`, `Latitude`, `Longitude`, `Time on Realtor`, `Inserted Date`, `Last Updated`, `Photos` (cover URL), `Photo Count`, `Agent Phone`.

For nested/large fields (full photo arrays, building amenities, all agents, history, etc.) the complete upstream JSON is in the `Raw` column.

---

### Sample input

```json
{
    "property_inputs": [
        "29729754",
        "https://www.realtor.ca/real-estate/29729754/1811-30-elm-drive-w-mississauga-fairview",
        "30 Elm Drive W, Mississauga, ON"
    ],
    "search_inputs": ["Toronto, Ontario", "M5V 2T6", "43.6532,-79.3832,3"],
    "searchType": "For_Sale",
    "propertyType": "Residential",
    "priceRange": "min:500000,max:1500000",
    "beds": "2+",
    "sortOrder": "Newest",
    "pages": 2,
    "resultCount": 50,

    "autocomplete_inputs": ["Yorkville"],
    "agent_search_inputs": ["Toronto"],
    "agent_detail_inputs": ["1633952"]
}
````

***

### Search filters (apply to all `search_inputs`)

- **searchType** — `For_Sale` (default) | `For_Rent` | `Sold`
- **propertyType** — comma list of `Residential, Recreational, Condo, Land, Agriculture, Parking, MultiFamily, Business, Retail, Industrial, Office, Hospitality, Institutional` (Realtor.ca only accepts one PropertySearchTypeId per call; if you supply multiple, the first wins)
- **priceRange / sqftRange / lotSizeRange / yearBuiltRange** — `min:X` | `max:Y` | `min:X,max:Y`
- **beds / baths** — `3` (3+), `3+`, or `min:3,max:5`
- **sortOrder** — `Newest`, `Oldest`, `Price_Low_to_High`, `Price_High_to_Low`, `Open_Houses_First`, `More_Photos_First`, `Virtual_Tour_First`
- **pages** — how many pages to fetch (1–50). Each page = `resultCount` listings.
- **resultCount** — 1–200 per page, default 50
- **ownership** — `Any` | `Freehold` | `Condo` | `TimeShare` | `Leasehold`
- **soldWithinDays** — only when `searchType=Sold`; `30` / `90` / `365` / empty
- **openHouseOnly / hasGarage / hasPool / hasFireplace / hasAirConditioning / publicOffersOnly** — toggles
- **keywords** — free-text amenities (e.g. `waterfront, finished basement`)

Filters apply to **every** `search_inputs` row in the run.

***

### Pricing

**Pay per result** — you only pay for dataset items the Actor pushes. Failed inputs return a row with `Status: ERROR: ...` and are billed the same as a successful row.

To cap spend, set `Max paid dataset items` on the run page.

***

### Tips

- **Need just one property?** Use the `property_inputs` section — auto-detects `property_id`, URL, or address.
- **Pull all listings in a city?** Use `search_inputs: ["City, Province"]` and crank `pages` (each page is up to 200 results).
- **Use a lat/lng circle?** Format: `43.6532,-79.3832,3` (last value is radius in miles).
- **Polygon?** `lon lat,lon lat,lon lat,...` — note longitude first (GeoJSON convention).
- **Resolve a Realtor.ca URL?** Drop a search or detail URL straight into the matching section — both `byurl` modes parse the URL into the right call internally.
- **Looking up agents?** Use `agent_search_inputs` for discovery, then take `id` values from the result and feed them into `agent_detail_inputs` for the full profile.

# Actor input Schema

## `property_inputs` (type: `array`):

Auto-detects each entry: digits → property\_id, http(s) URL → listing URL, anything else → address. Each row = 1 property detail call.

## `search_inputs` (type: `array`):

Auto-detects each entry. Examples:
• `Toronto, Ontario` (location)
• `M5V 2T6` (postal code — Canadian format)
• `43.6532,-79.3832,3` (lat,lng,radius\_miles)
• `-79.40 43.65,-79.35 43.65,-79.35 43.68,-79.40 43.68` (polygon, lon-lat pairs)
• `https://www.realtor.ca/map#ZoomLevel=...` (search URL)

Filters below apply to every search. Each LISTING is pushed as one dataset item.

## `searchType` (type: `string`):

For\_Sale (default) | For\_Rent | Sold. Realtor.ca's TransactionTypeId is mapped internally.

## `propertyType` (type: `string`):

Comma-separated. Leave empty for all. Allowed: Residential, Recreational, Condo, Land, Agriculture, Parking, MultiFamily, Business, Retail, Industrial, Office, Hospitality, Institutional. Note: Realtor.ca only accepts ONE PropertySearchTypeId per call; if you supply multiple the first wins.

## `priceRange` (type: `string`):

`min:500000`, `max:1500000`, or `min:500000,max:1500000`. Applied as PriceMin/Max for sales, RentMin/Max for rentals.

## `beds` (type: `string`):

Examples: `3` (3+), `3+`, `min:3,max:5`. Realtor.ca uses BedRange (e.g. `3-0` = 3 or more).

## `baths` (type: `string`):

Examples: `2` (2+), `2+`, `min:2,max:4`.

## `sqftRange` (type: `string`):

`min:800`, `max:2500`, `min:800,max:2500`

## `lotSizeRange` (type: `string`):

`min:0.25`, `max:1`, `min:0.25,max:1`

## `yearBuiltRange` (type: `string`):

`min:1990`, `max:2024`, `min:1990,max:2024`

## `sortOrder` (type: `string`):

How to sort search results.

## `pages` (type: `integer`):

1-based. Each page = up to `Result Count` listings.

## `resultCount` (type: `integer`):

Min 1, Max 200. Default 50.

## `ownership` (type: `string`):

Filter by ownership.

## `soldWithinDays` (type: `string`):

Only when searchType=Sold. Allowed: 30, 90, 365 (or empty for any).

## `openHouseOnly` (type: `boolean`):

Only listings with an upcoming open house.

## `hasGarage` (type: `boolean`):

Only listings with a garage.

## `hasPool` (type: `boolean`):

Only listings with a pool.

## `hasFireplace` (type: `boolean`):

Only listings with a fireplace.

## `hasAirConditioning` (type: `boolean`):

Only listings with air conditioning.

## `publicOffersOnly` (type: `boolean`):

Only listings with public offer system enabled.

## `keywords` (type: `string`):

Free-text amenities (e.g. `waterfront, finished basement`).

## `autocomplete_inputs` (type: `array`):

Realtor.ca search-box suggestions: cities, postal codes, MLS numbers, addresses.

## `agent_search_inputs` (type: `array`):

Search Realtor.ca's IndividualSearch. Each query pushes one row per matching agent.

## `agent_detail_inputs` (type: `array`):

Pulled from the `id` field on any agent search result. Pushes full agent profile (bio, specialties, areas served, listings).

## Actor input object example

```json
{
  "property_inputs": [
    "29729754",
    "https://www.realtor.ca/real-estate/29729754/1811-30-elm-drive-w-mississauga-fairview",
    "30 Elm Drive W, Mississauga, ON"
  ],
  "search_inputs": [
    "Toronto, Ontario"
  ],
  "searchType": "For_Sale",
  "propertyType": "",
  "priceRange": "",
  "beds": "",
  "baths": "",
  "sqftRange": "",
  "lotSizeRange": "",
  "yearBuiltRange": "",
  "sortOrder": "Newest",
  "pages": 1,
  "resultCount": 50,
  "ownership": "Any",
  "soldWithinDays": "",
  "openHouseOnly": false,
  "hasGarage": false,
  "hasPool": false,
  "hasFireplace": false,
  "hasAirConditioning": false,
  "publicOffersOnly": false,
  "keywords": ""
}
```

# 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 = {
    "property_inputs": [
        "29729754",
        "https://www.realtor.ca/real-estate/29729754/1811-30-elm-drive-w-mississauga-fairview",
        "30 Elm Drive W, Mississauga, ON"
    ],
    "search_inputs": [
        "Toronto, Ontario"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("one-api/realtorca-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "property_inputs": [
        "29729754",
        "https://www.realtor.ca/real-estate/29729754/1811-30-elm-drive-w-mississauga-fairview",
        "30 Elm Drive W, Mississauga, ON",
    ],
    "search_inputs": ["Toronto, Ontario"],
}

# Run the Actor and wait for it to finish
run = client.actor("one-api/realtorca-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 '{
  "property_inputs": [
    "29729754",
    "https://www.realtor.ca/real-estate/29729754/1811-30-elm-drive-w-mississauga-fairview",
    "30 Elm Drive W, Mississauga, ON"
  ],
  "search_inputs": [
    "Toronto, Ontario"
  ]
}' |
apify call one-api/realtorca-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=one-api/realtorca-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Realtor.ca Scraper",
        "description": "Scrape Realtor.ca (Canada national MLS) — full property details, search listings by location/postal code/coordinates/polygon/URL, agent profiles, and search-box autocomplete. Backed by realtyapi.io real-time API.",
        "version": "1.0",
        "x-build-id": "dLF0ecJXsEZruGDI5"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/one-api~realtorca-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-one-api-realtorca-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/one-api~realtorca-scraper/runs": {
            "post": {
                "operationId": "runs-sync-one-api-realtorca-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/one-api~realtorca-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-one-api-realtorca-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": {
                    "property_inputs": {
                        "title": "Property ID, Realtor.ca URL, or full Address (one per line)",
                        "type": "array",
                        "description": "Auto-detects each entry: digits → property_id, http(s) URL → listing URL, anything else → address. Each row = 1 property detail call.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "search_inputs": {
                        "title": "Location, postal code, lat/lng radius, polygon, or Realtor.ca search URL (one per line)",
                        "type": "array",
                        "description": "Auto-detects each entry. Examples:\n• `Toronto, Ontario` (location)\n• `M5V 2T6` (postal code — Canadian format)\n• `43.6532,-79.3832,3` (lat,lng,radius_miles)\n• `-79.40 43.65,-79.35 43.65,-79.35 43.68,-79.40 43.68` (polygon, lon-lat pairs)\n• `https://www.realtor.ca/map#ZoomLevel=...` (search URL)\n\nFilters below apply to every search. Each LISTING is pushed as one dataset item.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "searchType": {
                        "title": "Search Type",
                        "enum": [
                            "For_Sale",
                            "For_Rent",
                            "Sold"
                        ],
                        "type": "string",
                        "description": "For_Sale (default) | For_Rent | Sold. Realtor.ca's TransactionTypeId is mapped internally.",
                        "default": "For_Sale"
                    },
                    "propertyType": {
                        "title": "Property Type",
                        "type": "string",
                        "description": "Comma-separated. Leave empty for all. Allowed: Residential, Recreational, Condo, Land, Agriculture, Parking, MultiFamily, Business, Retail, Industrial, Office, Hospitality, Institutional. Note: Realtor.ca only accepts ONE PropertySearchTypeId per call; if you supply multiple the first wins.",
                        "default": ""
                    },
                    "priceRange": {
                        "title": "Price Range",
                        "type": "string",
                        "description": "`min:500000`, `max:1500000`, or `min:500000,max:1500000`. Applied as PriceMin/Max for sales, RentMin/Max for rentals.",
                        "default": ""
                    },
                    "beds": {
                        "title": "Beds",
                        "type": "string",
                        "description": "Examples: `3` (3+), `3+`, `min:3,max:5`. Realtor.ca uses BedRange (e.g. `3-0` = 3 or more).",
                        "default": ""
                    },
                    "baths": {
                        "title": "Baths",
                        "type": "string",
                        "description": "Examples: `2` (2+), `2+`, `min:2,max:4`.",
                        "default": ""
                    },
                    "sqftRange": {
                        "title": "Interior Sqft Range",
                        "type": "string",
                        "description": "`min:800`, `max:2500`, `min:800,max:2500`",
                        "default": ""
                    },
                    "lotSizeRange": {
                        "title": "Lot Size Range (acres)",
                        "type": "string",
                        "description": "`min:0.25`, `max:1`, `min:0.25,max:1`",
                        "default": ""
                    },
                    "yearBuiltRange": {
                        "title": "Year Built Range",
                        "type": "string",
                        "description": "`min:1990`, `max:2024`, `min:1990,max:2024`",
                        "default": ""
                    },
                    "sortOrder": {
                        "title": "Sort Order",
                        "enum": [
                            "Newest",
                            "Oldest",
                            "Price_Low_to_High",
                            "Price_High_to_Low",
                            "Open_Houses_First",
                            "More_Photos_First",
                            "Virtual_Tour_First"
                        ],
                        "type": "string",
                        "description": "How to sort search results.",
                        "default": "Newest"
                    },
                    "pages": {
                        "title": "Pages to fetch per search",
                        "minimum": 1,
                        "maximum": 50,
                        "type": "integer",
                        "description": "1-based. Each page = up to `Result Count` listings.",
                        "default": 1
                    },
                    "resultCount": {
                        "title": "Results per page",
                        "minimum": 1,
                        "maximum": 200,
                        "type": "integer",
                        "description": "Min 1, Max 200. Default 50.",
                        "default": 50
                    },
                    "ownership": {
                        "title": "Ownership Type",
                        "enum": [
                            "Any",
                            "Freehold",
                            "Condo",
                            "TimeShare",
                            "Leasehold"
                        ],
                        "type": "string",
                        "description": "Filter by ownership.",
                        "default": "Any"
                    },
                    "soldWithinDays": {
                        "title": "Sold within (days)",
                        "enum": [
                            "",
                            "30",
                            "90",
                            "365"
                        ],
                        "type": "string",
                        "description": "Only when searchType=Sold. Allowed: 30, 90, 365 (or empty for any).",
                        "default": ""
                    },
                    "openHouseOnly": {
                        "title": "Open House Only",
                        "type": "boolean",
                        "description": "Only listings with an upcoming open house.",
                        "default": false
                    },
                    "hasGarage": {
                        "title": "Has Garage",
                        "type": "boolean",
                        "description": "Only listings with a garage.",
                        "default": false
                    },
                    "hasPool": {
                        "title": "Has Pool",
                        "type": "boolean",
                        "description": "Only listings with a pool.",
                        "default": false
                    },
                    "hasFireplace": {
                        "title": "Has Fireplace",
                        "type": "boolean",
                        "description": "Only listings with a fireplace.",
                        "default": false
                    },
                    "hasAirConditioning": {
                        "title": "Has Air Conditioning",
                        "type": "boolean",
                        "description": "Only listings with air conditioning.",
                        "default": false
                    },
                    "publicOffersOnly": {
                        "title": "Public Offers Only",
                        "type": "boolean",
                        "description": "Only listings with public offer system enabled.",
                        "default": false
                    },
                    "keywords": {
                        "title": "Keywords",
                        "type": "string",
                        "description": "Free-text amenities (e.g. `waterfront, finished basement`).",
                        "default": ""
                    },
                    "autocomplete_inputs": {
                        "title": "Autocomplete query (one per line)",
                        "type": "array",
                        "description": "Realtor.ca search-box suggestions: cities, postal codes, MLS numbers, addresses.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "agent_search_inputs": {
                        "title": "Agent search query — name or location (one per line)",
                        "type": "array",
                        "description": "Search Realtor.ca's IndividualSearch. Each query pushes one row per matching agent.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "agent_detail_inputs": {
                        "title": "Agent ID (one per line)",
                        "type": "array",
                        "description": "Pulled from the `id` field on any agent search result. Pushes full agent profile (bio, specialties, areas served, listings).",
                        "items": {
                            "type": "string"
                        }
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
