# Etuovi.com Scraper — Finland Real Estate (`logiover/etuovi-scraper-finland-real-estate`) Actor

Scrape Etuovi.com — Finland's #1 real estate portal via its internal search API. Extract price, area, rooms, build year, energy class, GPS coordinates, agency and agent info for sale listings across all Finnish cities.

- **URL**: https://apify.com/logiover/etuovi-scraper-finland-real-estate.md
- **Developed by:** [Logiover](https://apify.com/logiover) (community)
- **Categories:** Real estate, Automation, Developer tools
- **Stats:** 2 total users, 2 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.50 / 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

## 🏠 Etuovi.com Scraper — Finland Real Estate

Scrape property listings from [etuovi.com](https://www.etuovi.com) — Finland's #1 real estate portal with over 59,000 active listings. Uses Etuovi's internal search API directly — no browser, no proxy required, extremely fast.

---

### 📦 What you get

| Field | Description | Example |
|-------|-------------|---------|
| `title` | Generated listing title | `"Apartment — 3h, kt, kph, s — 59.5 m² — Leppävaara Espoo"` |
| `propertyType` | Property category | `"RESIDENTIAL"` |
| `propertySubtype` | Property type in English | `"Apartment (Kerrostalo)"` |
| `priceFormatted` | Asking price | `"298 000 €"` |
| `price` | Numeric price | `298000` |
| `area` | Living area m² | `59.5` |
| `totalArea` | Total area m² | `59.5` |
| `rooms` | Finnish room description | `"3h, kt, kph, s, lasitettu parveke"` |
| `roomCount` | Standardized room count | `"3"` |
| `buildYear` | Construction year | `"2019"` |
| `isNewBuilding` | New construction flag | `false` |
| `address` | Full address | `"Kaarlo Sarkian katu 10 Vermonniitty Espoo"` |
| `addressLine1` | Street address | `"Kaarlo Sarkian katu 10"` |
| `addressLine2` | District and city | `"Vermonniitty Espoo"` |
| `city` | City | `"Espoo"` |
| `district` | Neighborhood | `"Vermonniitty"` |
| `latitude` | GPS latitude | `60.214195` |
| `longitude` | GPS longitude | `24.832643` |
| `agencyName` | Real estate agency | `"Kiinteistömaailma Espoo Leppävaara"` |
| `agencyUrl` | Agency website | `"http://www.kiinteistomaailma.fi/"` |
| `agentName` | Individual agent | `"Sari Palomäki"` |
| `isPrivateSeller` | Private listing | `false` |
| `imageThumbnail` | Main photo URL | `"https://d3ls91xgksobn.cloudfront.net/..."` |
| `imageUrls` | All photo URLs | `["https://..."]` |
| `publishedDate` | Publication date | `"2026-04-06"` |

---

### 🚀 How to use

#### Basic — all Finland, newest first

```json
{
  "propertyType": "RESIDENTIAL",
  "maxListings": 200
}
````

#### Filter by city

```json
{
  "propertyType": "RESIDENTIAL",
  "locations": ["Helsinki"],
  "maxListings": 500
}
```

#### Multiple cities

```json
{
  "locations": ["Helsinki", "Espoo", "Vantaa"],
  "propertySubtypes": ["APARTMENT_HOUSE"],
  "maxListings": 1000
}
```

#### Price + area filter

```json
{
  "propertyType": "RESIDENTIAL",
  "locations": ["Tampere"],
  "minPrice": 100000,
  "maxPrice": 300000,
  "minArea": 40,
  "maxArea": 100,
  "sortBy": "SEARCH_PRICE_ASC",
  "maxListings": 200
}
```

#### New construction only

```json
{
  "propertyType": "RESIDENTIAL",
  "newBuildingOnly": true,
  "maxListings": 500
}
```

#### Vacation homes

```json
{
  "propertyType": "VACATION",
  "maxListings": 200
}
```

#### Private sellers only

```json
{
  "sellerType": "PRIVATE",
  "maxListings": 200
}
```

***

### ⚙️ Input parameters

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `propertyType` | string | `RESIDENTIAL` | `RESIDENTIAL`, `VACATION`, `PLOT`, `COMMERCIAL` |
| `propertySubtypes` | array | `[]` | `APARTMENT_HOUSE`, `DETACHED_HOUSE`, `ROW_HOUSE`, `SEMI_DETACHED_HOUSE` |
| `locations` | array | `[]` (all Finland) | City names: `Helsinki`, `Espoo`, `Tampere`, `Turku`, `Oulu`, `Vantaa`, etc. |
| `minPrice` | integer | — | Minimum price in EUR |
| `maxPrice` | integer | — | Maximum price in EUR |
| `minArea` | number | — | Minimum living area m² |
| `maxArea` | number | — | Maximum living area m² |
| `minRooms` | integer | — | Minimum number of rooms |
| `maxRooms` | integer | — | Maximum number of rooms |
| `minBuildYear` | integer | — | Minimum construction year |
| `maxBuildYear` | integer | — | Maximum construction year |
| `newBuildingOnly` | boolean | `false` | New construction only |
| `sellerType` | string | `ALL` | `ALL`, `PRIVATE`, `COMPANY` |
| `sortBy` | string | `PUBLISHED_OR_UPDATED_AT` | Sort order |
| `maxListings` | integer | `200` | Max results (0 = unlimited) |
| `proxyConfiguration` | object | disabled | Optional proxy |

***

### 💡 Use cases

**Finnish housing market analysis** — Etuovi is the definitive source for Finnish property data. Scrape the full 59,000+ listing database for price-per-m² analysis by city, neighborhood or build year. Track how Helsinki prices compare to Tampere or Oulu over time.

**Investment opportunity finder** — Filter by `sellerType: PRIVATE` to find private sellers who typically list 5–15% below agency prices. Combine with `locations` for specific target markets.

**New construction tracking** — Set `newBuildingOnly: true` to monitor all new developments across Finland. Developers and investors use this for competitor analysis and market saturation research.

**Price alert system** — Schedule daily runs with `sortBy: PUBLISHED_OR_UPDATED_AT` to catch new listings the moment they go live. Feed results to a webhook for instant Slack or email notifications.

**Vacation home market research** — Set `propertyType: VACATION` to scrape the Finnish summer cottage market. Finland has over 500,000 registered summer cottages — a unique asset class with strong domestic demand.

**Real estate agency analysis** — Extract `agencyName`, `agencyId`, and `agencyUrl` from listings to build a database of all active Finnish real estate agencies, their listing volumes, and geographic coverage.

**GPS-enriched property data** — Every listing includes `latitude` and `longitude` coordinates, making it trivial to build map visualizations, calculate distances to schools/transport, and perform spatial analysis.

**Expat relocation research** — Filter Helsinki-area listings by area and price for relocation budgeting. Finnish listings include the unique `totalArea` field which includes storage and common areas — important for comparing Finnish vs international space standards.

***

### 📊 Sample output

```json
{
  "listingId": "2531560",
  "friendlyId": "1412825",
  "listingUrl": "https://www.etuovi.com/kohde/2531560",
  "title": "Apartment (Kerrostalo) — 3h, kt, kph, s, lasitettu parveke — 59.5 m² — Vermonniitty Espoo",
  "propertyType": "RESIDENTIAL",
  "propertySubtype": "Apartment (Kerrostalo)",
  "price": 298000,
  "priceFormatted": "298 000 €",
  "area": 59.5,
  "totalArea": 59.5,
  "rooms": "3h, kt, kph, s, lasitettu parveke",
  "roomCount": "3",
  "buildYear": "2019",
  "isNewBuilding": false,
  "address": "Kaarlo Sarkian katu 10 Vermonniitty Espoo",
  "addressLine1": "Kaarlo Sarkian katu 10",
  "addressLine2": "Vermonniitty Espoo",
  "city": "Espoo",
  "district": "Vermonniitty",
  "latitude": 60.214195,
  "longitude": 24.832643,
  "agencyName": "Kiinteistömaailma Espoo Leppävaara | Suur-Leppävaara LKV Oy",
  "agencyUrl": "http://www.kiinteistomaailma.fi/",
  "agentName": null,
  "isPrivateSeller": false,
  "imageThumbnail": "https://d3ls91xgksobn.cloudfront.net/400x300/etuovimedia/images/...",
  "imageUrls": ["https://d3ls91xgksobn.cloudfront.net/1200x900/etuovimedia/images/..."],
  "hasOpenBidding": false,
  "publishedDate": "2026-04-06",
  "scrapedAt": "2026-04-06T12:00:00.000Z"
}
```

***

### ⚡ Performance

| Mode | Speed |
|------|-------|
| 200 listings | ~6 seconds |
| 1,000 listings | ~30 seconds |
| Full database (~59,000) | ~30 minutes |

Each API call returns 30 listings. The scraper makes one call per page with 800ms polite delay. No browser, no rendering, no proxy needed for standard use.

***

### 🔧 Technical notes

- **API endpoint:** `POST https://www.etuovi.com/api/v3/announcements/search/listpage`
- **No authentication required** — Etuovi's search API is publicly accessible without API keys
- **Rate limiting:** 800ms delay between requests — respectful of the server
- **Retry logic:** Up to 3 retries with exponential backoff on failures or 429 rate limits
- **Image resolution:** Thumbnails at `400x300`, full images at `1200x900` — resolution can be changed by modifying the `IMAGE_SIZE` constant
- **Coordinates:** All listings include GPS coordinates — useful for mapping and spatial analysis

# Actor input Schema

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

Type of property to search. RESIDENTIAL covers apartments, houses, terraced houses. VACATION is for summer cottages and holiday homes. PLOT is for land plots.

## `propertySubtypes` (type: `array`):

Filter by specific property subtypes. Leave empty to include all. Options: APARTMENT\_HOUSE (kerrostalo), DETACHED\_HOUSE (omakotitalo), ROW\_HOUSE (rivitalo), SEMI\_DETACHED\_HOUSE (paritalo).

## `locations` (type: `array`):

Filter by city or region. Each entry is a location term like 'Helsinki', 'Espoo', 'Tampere', 'Turku', 'Oulu', 'Vantaa'. Leave empty for all Finland.

## `minPrice` (type: `integer`):

Minimum asking price in EUR.

## `maxPrice` (type: `integer`):

Maximum asking price in EUR.

## `minArea` (type: `number`):

Minimum living area in square metres.

## `maxArea` (type: `number`):

Maximum living area in square metres.

## `minRooms` (type: `integer`):

Minimum number of rooms.

## `maxRooms` (type: `integer`):

Maximum number of rooms.

## `minBuildYear` (type: `integer`):

Minimum construction year (e.g. 2000 for properties built after 2000).

## `maxBuildYear` (type: `integer`):

Maximum construction year.

## `newBuildingOnly` (type: `boolean`):

When enabled, only return new construction listings (uudiskohteet).

## `sellerType` (type: `string`):

Filter by seller type. ALL includes both agencies and private sellers.

## `sortBy` (type: `string`):

How to sort results.

## `maxListings` (type: `integer`):

Maximum number of listings to scrape. Set to 0 for unlimited. Etuovi returns 30 listings per API page. The full database has ~60,000 active listings.

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

Optional proxy settings. The Etuovi API works without proxy for standard runs.

## Actor input object example

```json
{
  "propertyType": "RESIDENTIAL",
  "propertySubtypes": [],
  "locations": [],
  "newBuildingOnly": false,
  "sellerType": "ALL",
  "sortBy": "PUBLISHED_OR_UPDATED_AT",
  "maxListings": 200,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `listingId` (type: `string`):

Etuovi internal listing ID

## `friendlyId` (type: `string`):

Human-readable listing reference number

## `listingUrl` (type: `string`):

Full listing URL on etuovi.com

## `title` (type: `string`):

Generated listing title

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

RESIDENTIAL, VACATION, PLOT, COMMERCIAL

## `propertySubtype` (type: `string`):

APARTMENT\_HOUSE, DETACHED\_HOUSE, ROW\_HOUSE...

## `price` (type: `string`):

Asking price in EUR

## `priceFormatted` (type: `string`):

Formatted price string

## `area` (type: `string`):

Living area in square metres

## `totalArea` (type: `string`):

Total area including other spaces

## `rooms` (type: `string`):

Finnish room description (e.g. 3h+k+s)

## `roomCount` (type: `string`):

Standardized room count category

## `buildYear` (type: `string`):

Construction finished year

## `isNewBuilding` (type: `string`):

Is a new construction listing

## `address` (type: `string`):

Full location string

## `addressLine1` (type: `string`):

Street name and number

## `addressLine2` (type: `string`):

District and city

## `city` (type: `string`):

City

## `district` (type: `string`):

Neighborhood / district

## `latitude` (type: `string`):

GPS latitude coordinate

## `longitude` (type: `string`):

GPS longitude coordinate

## `agencyId` (type: `string`):

Etuovi office ID

## `agencyName` (type: `string`):

Real estate agency name

## `agencyUrl` (type: `string`):

Agency website URL

## `agentName` (type: `string`):

Individual agent name

## `isPrivateSeller` (type: `string`):

Listed by owner, not an agency

## `privateSellerName` (type: `string`):

Name of private seller if applicable

## `imageThumbnail` (type: `string`):

Main listing photo URL

## `imageUrls` (type: `string`):

All available photo URLs

## `hasOpenBidding` (type: `string`):

Property is in open bidding process

## `publishedDate` (type: `string`):

Listing publication date

## `scrapedAt` (type: `string`):

ISO timestamp of the scrape

# 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 = {
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("logiover/etuovi-scraper-finland-real-estate").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 = { "proxyConfiguration": { "useApifyProxy": False } }

# Run the Actor and wait for it to finish
run = client.actor("logiover/etuovi-scraper-finland-real-estate").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 '{
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call logiover/etuovi-scraper-finland-real-estate --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=logiover/etuovi-scraper-finland-real-estate",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Etuovi.com Scraper — Finland Real Estate",
        "description": "Scrape Etuovi.com — Finland's #1 real estate portal via its internal search API. Extract price, area, rooms, build year, energy class, GPS coordinates, agency and agent info for sale listings across all Finnish cities.",
        "version": "0.0",
        "x-build-id": "AfGDEn3UMZbWnL2QW"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/logiover~etuovi-scraper-finland-real-estate/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-logiover-etuovi-scraper-finland-real-estate",
                "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/logiover~etuovi-scraper-finland-real-estate/runs": {
            "post": {
                "operationId": "runs-sync-logiover-etuovi-scraper-finland-real-estate",
                "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/logiover~etuovi-scraper-finland-real-estate/run-sync": {
            "post": {
                "operationId": "run-sync-logiover-etuovi-scraper-finland-real-estate",
                "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": {
                    "propertyType": {
                        "title": "Property Type",
                        "enum": [
                            "RESIDENTIAL",
                            "VACATION",
                            "PLOT",
                            "COMMERCIAL"
                        ],
                        "type": "string",
                        "description": "Type of property to search. RESIDENTIAL covers apartments, houses, terraced houses. VACATION is for summer cottages and holiday homes. PLOT is for land plots.",
                        "default": "RESIDENTIAL"
                    },
                    "propertySubtypes": {
                        "title": "Property Subtypes",
                        "type": "array",
                        "description": "Filter by specific property subtypes. Leave empty to include all. Options: APARTMENT_HOUSE (kerrostalo), DETACHED_HOUSE (omakotitalo), ROW_HOUSE (rivitalo), SEMI_DETACHED_HOUSE (paritalo).",
                        "default": [],
                        "items": {
                            "type": "string"
                        }
                    },
                    "locations": {
                        "title": "Locations",
                        "type": "array",
                        "description": "Filter by city or region. Each entry is a location term like 'Helsinki', 'Espoo', 'Tampere', 'Turku', 'Oulu', 'Vantaa'. Leave empty for all Finland.",
                        "default": [],
                        "items": {
                            "type": "string"
                        }
                    },
                    "minPrice": {
                        "title": "Min Price (€)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Minimum asking price in EUR."
                    },
                    "maxPrice": {
                        "title": "Max Price (€)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Maximum asking price in EUR."
                    },
                    "minArea": {
                        "title": "Min Area (m²)",
                        "minimum": 0,
                        "type": "number",
                        "description": "Minimum living area in square metres."
                    },
                    "maxArea": {
                        "title": "Max Area (m²)",
                        "minimum": 0,
                        "type": "number",
                        "description": "Maximum living area in square metres."
                    },
                    "minRooms": {
                        "title": "Min Rooms",
                        "minimum": 1,
                        "type": "integer",
                        "description": "Minimum number of rooms."
                    },
                    "maxRooms": {
                        "title": "Max Rooms",
                        "minimum": 1,
                        "type": "integer",
                        "description": "Maximum number of rooms."
                    },
                    "minBuildYear": {
                        "title": "Min Build Year",
                        "type": "integer",
                        "description": "Minimum construction year (e.g. 2000 for properties built after 2000)."
                    },
                    "maxBuildYear": {
                        "title": "Max Build Year",
                        "type": "integer",
                        "description": "Maximum construction year."
                    },
                    "newBuildingOnly": {
                        "title": "New Buildings Only",
                        "type": "boolean",
                        "description": "When enabled, only return new construction listings (uudiskohteet).",
                        "default": false
                    },
                    "sellerType": {
                        "title": "Seller Type",
                        "enum": [
                            "ALL",
                            "PRIVATE",
                            "COMPANY"
                        ],
                        "type": "string",
                        "description": "Filter by seller type. ALL includes both agencies and private sellers.",
                        "default": "ALL"
                    },
                    "sortBy": {
                        "title": "Sort By",
                        "enum": [
                            "PUBLISHED_OR_UPDATED_AT",
                            "SEARCH_PRICE_ASC",
                            "SEARCH_PRICE_DESC",
                            "AREA_ASC",
                            "AREA_DESC"
                        ],
                        "type": "string",
                        "description": "How to sort results.",
                        "default": "PUBLISHED_OR_UPDATED_AT"
                    },
                    "maxListings": {
                        "title": "Max Listings",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Maximum number of listings to scrape. Set to 0 for unlimited. Etuovi returns 30 listings per API page. The full database has ~60,000 active listings.",
                        "default": 200
                    },
                    "proxyConfiguration": {
                        "title": "Proxy Configuration",
                        "type": "object",
                        "description": "Optional proxy settings. The Etuovi API works without proxy for standard runs."
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
