# Idealista Scraper (`hotels-scrapers/idealista-scraper`) Actor Scrape Idealista real estate listings across Spain, Italy & Portugal. Extract price, GPS, energy rating, rooms, agency contact. DataDome bypass included. - **URL**: https://apify.com/hotels-scrapers/idealista-scraper.md - **Developed by:** [Hotels Scraper](https://apify.com/hotels-scrapers) (community) - **Categories:** Real estate, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing from $3.00 / 1,000 listings This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. 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 **Idealista Scraper** extracts real estate listing data from [Idealista](https://www.idealista.com) — the #1 property portal in Spain, Italy, and Portugal. Pull prices, GPS coordinates, energy ratings, room counts, sizes, and agency contacts from any city, region, or full Idealista search URL. Built for property investors, proptech teams, market analysts, and data brokers who need a reliable **Idealista API** alternative without fighting DataDome anti-bot. ### What does Idealista Scraper do? - Extract Idealista listings across **Spain (idealista.com), Italy (idealista.it), Portugal (idealista.pt)** - Filter by operation (sale / rent), property type, price, size, bedrooms, bathrooms, amenities - Returns **GPS coordinates, energy rating, price/m², rooms, photos, agency contact** - Up to **1,800 listings per search** (Idealista's hard cap) - Handles **DataDome anti-bot** automatically — `nodriver` + warmed residential profile - Optional detail-page enrichment: address, geo, bathrooms, full amenities, agency phone - Works on Apify Free plan — proxy rotation, scheduling, webhooks, REST API included ### Why scrape Idealista? Idealista is the dominant real estate platform in Southern Europe (60M+ monthly visits). Its public listing data is the canonical price signal for: - **Investors** — yield analysis, neighborhood price tracking, comp sets across Madrid / Barcelona / Milan / Lisbon - **Proptech & valuation models** — feed AVMs with GPS-accurate, energy-rating-tagged comps - **Real estate agencies** — competitive monitoring of competitor inventory and pricing - **Researchers & journalists** — Southern European housing dynamics, EU energy-certificate analysis Idealista has no public API. This scraper is the practical alternative. ### What data can Idealista Scraper extract? | Field | Type | Description | |---|---|---| | `listingId` | string | Idealista internal listing ID | | `url` | string | Canonical listing URL | | `locale` | `ES` \| `IT` \| `PT` | Country site | | `price` | number | Asking price (€) | | `pricePerSqm` | number | Price per m² | | `rooms` | int | Bedroom count | | `size` | number | Square meters | | `energyRating` | `A`–`G` | EU Energy Performance Certificate | | `latitude` / `longitude` | number | GPS coordinates | | `title` | string | Listing headline | | `propertyType` | string | Home / office / land / etc. | | `agencySlug` / `agencyPhone` | string | Listing agent (Spain) | | `amenities`, `photos`, `priceHistory` | array | Detail-page enrichment | Detail page also returns: `description`, `floor`, `elevator`, `parking`, `garage`, full feature flags. ### How to scrape Idealista listings 1. Open **Idealista Scraper** on Apify and click **Try for free** 2. Pick **Country** (Spain / Italy / Portugal) and **Operation** (sale / rent) 3. Enter a **Location** — either a slug like `madrid-comunidad_de_madrid` or a full Idealista search URL 4. Set **Max items** (1–1800) and any filters (price, bedrooms, amenities) 5. Toggle **Fetch listing details** if you need address, geo, agency phone (~10× requests) 6. Click **Start** — results stream into the dataset; export as JSON / CSV / Excel / HTML / XML or pull via Apify API Heavy DataDome region? Plug a premium residential proxy into **Custom Proxy URL** (Decodo / Bright Data / IPRoyal ES residential). ### How much does it cost to scrape Idealista? **€1.50 per 1,000 listings** — Pay-Per-Result pricing. | Volume | Cost | Typical use | |---|---|---| | 1,000 listings | €1.50 | One city district, full sweep | | 10,000 listings | €15.00 | ~5 metro searches across Spain | | 100,000 listings | €150.00 | Full Madrid + Barcelona + Valencia snapshot | **On the Apify Free plan ($5 platform credit), you can extract roughly 3,000+ Idealista listings.** Compare: ScrapingBee Idealista feed €299+/mo · Bright Data dataset enterprise pricing. No subscription, no platform fees on top. `fetchDetails: true` does not change result price but increases run time and proxy usage. ### Input Configure runs from the **Input** tab. Minimum required: `operation`, `propertyType`, `country`, `location`. ```json { "operation": "sale", "propertyType": "homes", "country": "es", "location": "madrid-comunidad_de_madrid", "maxItems": 100, "sortBy": "mostRecent", "minPrice": 200000, "maxPrice": 600000, "bedrooms": ["2", "3"], "fetchDetails": false } ```` `location` accepts an Idealista URL slug **or** a full search URL (passthrough — all UI filters override slug-based behavior). Boolean amenity flags (`balcony`, `terrace`, `lift`, `swimmingPool`, `seaViews`, `luxury`, `virtualTour`, …) map 1:1 to Idealista's filter UI. ### Output ```json { "listingId": "99887766", "url": "https://www.idealista.com/inmueble/99887766/", "locale": "ES", "price": 450000, "pricePerSqm": 4500, "rooms": 3, "size": 100.0, "energyRating": "B", "latitude": 40.4168, "longitude": -3.7038, "title": "Piso en Madrid centro 3 habitaciones", "propertyType": "flat", "amenities": ["lift", "balcony"], "photos": ["https://img4.idealista.com/blur/..."], "agencySlug": "inmobiliaria-centro", "agencyPhone": "+34 91 123 4567", "scrapedAt": "2026-04-28T10:00:00Z" } ``` Download the full dataset as **JSON, CSV, Excel, HTML, or XML** from the Storage tab, or pull it via the [Apify API](https://docs.apify.com/api/v2). ### Tips - **Start narrow.** Idealista caps results at ~1,800 per search. Split big metros by district or property type. - **Skip `fetchDetails` first.** The list-page data covers price, size, rooms, energy rating, GPS for most use cases. Only enable details when you need agency phone or full amenities. - **Bring your own proxy** for hardened DataDome targets. Spanish residential IPs from Decodo / Bright Data / IPRoyal outperform shared pools. - **Schedule incremental runs** with `publicationDate=W` (last week) or `T`/`Y` (last 24/48h) to track new inventory cheaply. - **Geo-fence with the slug.** `madrid-comunidad_de_madrid` ≠ `madrid-madrid` — first is the region, second is the city. ### TypeScript schema ```typescript interface IdealistaListing { listingId: string | null; url: string; locale: "ES" | "IT" | "PT"; price: number | null; pricePerSqm: number | null; rooms: number | null; size: number | null; energyRating: "A" | "B" | "C" | "D" | "E" | "F" | "G" | null; latitude: number | null; longitude: number | null; amenities: string[]; photos: string[]; priceHistory: object[]; agencySlug: string | null; agencyPhone: string | null; title: string | null; description: string | null; propertyType: string | null; floor: string | null; elevator: boolean | null; parking: boolean | null; garage: boolean | null; } ``` ### Other real estate scrapers | Actor | Use case | |---|---| | **Airbnb Scraper** | Short-term rental listings & pricing | | **LoopNet Scraper** | US commercial real estate | | **Idealista Scraper** *(this actor)* | Spain / Italy / Portugal residential & commercial | ### Is it legal to scrape Idealista? Our scrapers are ethical and do not extract any private user data, such as email addresses, gender, or location. They only extract what the user has chosen to share publicly. We therefore believe that our scrapers, when used for ethical purposes by Apify users, are safe. However, you should be aware that your results could contain personal data (e.g. agent phone numbers published on the listing). Personal data is protected by the GDPR in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers. ### FAQ **Does it bypass Idealista's DataDome anti-bot?** Yes. The actor uses `nodriver` (real browser automation) with pre-warmed behavioral profiles tuned for DataDome. For aggressive blocking, plug in a premium ES residential proxy via `customProxyUrl`. **Can I scrape Spain, Italy, and Portugal in one run?** One country per run — the `country` input is single-select (`es` / `it` / `pt`). Schedule three runs in parallel; Apify routes each to the correct residential proxy region. **Is there an official Idealista API?** Idealista offers a partner API to licensed real estate agencies only (no public access, requires application + commercial agreement). This actor is the practical alternative for everyone else. **What's the 1,800-listing cap?** Idealista limits search results to ~1,800 per query. For larger markets, split by district, property subtype, or price band. Combine results downstream. **Can you build a custom version (polygon search, daily diffs, custom fields)?** Yes — contact us through the Apify Store actor page. Custom scraping work and dedicated SLA available. **How fresh is the data?** Live — every run hits Idealista directly. Schedule runs hourly / daily via Apify Scheduler for continuous monitoring. # Actor input Schema ## `fetchDetails` (type: `boolean`): Visit each listing's detail page (curl\_cffi + DataDome cookie; Camoufox fallback) to enrich with address, geo coords, bathrooms, energy rating, agency contact, and full feature list. ~10× more requests — slower and higher block risk. Adds the 'enriched listing' charge ($0.003/listing) on top of standard dataset-item billing. ## `operation` (type: `string`): Listing operation ## `propertyType` (type: `string`): Type of property ## `country` (type: `string`): Idealista country site ## `location` (type: `string`): Idealista location URL slug (e.g. 'madrid-comunidad\_de\_madrid', 'barcelona-barcelona') OR a full Idealista search URL (passthrough). City names like 'Madrid' are accepted but resolved best-effort. ## `maxItems` (type: `integer`): Maximum number of listings to extract (1-1800; Idealista caps results around 1800) ## `sortBy` (type: `string`): Sorting method ## `minPrice` (type: `integer`): Minimum price; 0 = any ## `maxPrice` (type: `integer`): Maximum price; 0 = any ## `minSize` (type: `integer`): Minimum size in m²; 0 = any ## `maxSize` (type: `integer`): Maximum size in m²; 0 = any ## `publicationDate` (type: `string`): Filter by publication recency ## `bedrooms` (type: `array`): Bedroom counts to include ## `bathrooms` (type: `array`): Bathroom counts to include ## `homeType` (type: `array`): Home subtypes (only with propertyType=homes) ## `condition` (type: `array`): Property condition ## `floor` (type: `array`): Floor positions ## `airConditioning` (type: `boolean`): Only show listings with air conditioning ## `fittedWardrobes` (type: `boolean`): Only show listings with fitted wardrobes ## `lift` (type: `boolean`): Only show listings with a lift ## `balcony` (type: `boolean`): Only show listings with a balcony ## `terrace` (type: `boolean`): Only show listings with a terrace ## `exterior` (type: `boolean`): Only show exterior-facing listings ## `garage` (type: `boolean`): Only show listings with garage / parking ## `garden` (type: `boolean`): Only show listings with a garden ## `swimmingPool` (type: `boolean`): Only show listings with swimming pool ## `storageRoom` (type: `boolean`): Only show listings with storage room ## `accessible` (type: `boolean`): Only show wheelchair-accessible listings ## `seaViews` (type: `boolean`): Only show listings with sea views ## `luxury` (type: `boolean`): Only show luxury listings ## `plan` (type: `boolean`): Only show listings with floor plan ## `virtualTour` (type: `boolean`): Only show listings with virtual tour ## `customProxyUrl` (type: `string`): Optional: full proxy URL (http://user:pass@host:port). Overrides Apify proxy. Recommended for hardened DataDome targets — Apify residential pool may be burned. Use Decodo / Bright Data / IPRoyal ES residential. ## `proxyConfiguration` (type: `object`): Apify residential proxy. Defaults to Spain (ES) — change country code to IT or PT when scraping idealista.it / idealista.pt. ## Actor input object example ```json { "fetchDetails": false, "operation": "sale", "propertyType": "homes", "country": "es", "location": "madrid-comunidad_de_madrid", "maxItems": 5, "sortBy": "relevance", "minPrice": 0, "maxPrice": 0, "minSize": 0, "maxSize": 0, "publicationDate": "", "bedrooms": [], "bathrooms": [], "homeType": [], "condition": [], "floor": [], "airConditioning": false, "fittedWardrobes": false, "lift": false, "balcony": false, "terrace": false, "exterior": false, "garage": false, "garden": false, "swimmingPool": false, "storageRoom": false, "accessible": false, "seaViews": false, "luxury": false, "plan": false, "virtualTour": false, "customProxyUrl": "http://user:pass@es.smartproxy.com:7000", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "ES" } } ``` # 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 = { "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "ES" } }; // Run the Actor and wait for it to finish const run = await client.actor("hotels-scrapers/idealista-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "ES", } } # Run the Actor and wait for it to finish run = client.actor("hotels-scrapers/idealista-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 '{ "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "ES" } }' | apify call hotels-scrapers/idealista-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=hotels-scrapers/idealista-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Idealista Scraper", "description": "Scrape Idealista real estate listings across Spain, Italy & Portugal. Extract price, GPS, energy rating, rooms, agency contact. DataDome bypass included.", "version": "0.1", "x-build-id": "NXH4e2mWb0FjYyPqp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/hotels-scrapers~idealista-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-hotels-scrapers-idealista-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/hotels-scrapers~idealista-scraper/runs": { "post": { "operationId": "runs-sync-hotels-scrapers-idealista-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/hotels-scrapers~idealista-scraper/run-sync": { "post": { "operationId": "run-sync-hotels-scrapers-idealista-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", "required": [ "operation", "propertyType", "country", "location" ], "properties": { "fetchDetails": { "title": "⭐ Fetch listing details (recommended for richer data)", "type": "boolean", "description": "Visit each listing's detail page (curl_cffi + DataDome cookie; Camoufox fallback) to enrich with address, geo coords, bathrooms, energy rating, agency contact, and full feature list. ~10× more requests — slower and higher block risk. Adds the 'enriched listing' charge ($0.003/listing) on top of standard dataset-item billing.", "default": false }, "operation": { "title": "Operation", "enum": [ "sale", "rent" ], "type": "string", "description": "Listing operation", "default": "sale" }, "propertyType": { "title": "Property Type", "enum": [ "homes", "newDevelopments", "offices", "premises", "garages", "lands", "storageRooms", "buildings", "bedrooms" ], "type": "string", "description": "Type of property", "default": "homes" }, "country": { "title": "Country", "enum": [ "es", "it", "pt" ], "type": "string", "description": "Idealista country site", "default": "es" }, "location": { "title": "Location (URL slug or full search URL)", "type": "string", "description": "Idealista location URL slug (e.g. 'madrid-comunidad_de_madrid', 'barcelona-barcelona') OR a full Idealista search URL (passthrough). City names like 'Madrid' are accepted but resolved best-effort.", "default": "madrid-madrid" }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 1800, "type": "integer", "description": "Maximum number of listings to extract (1-1800; Idealista caps results around 1800)", "default": 5 }, "sortBy": { "title": "Sort By", "enum": [ "relevance", "lowestPrice", "highestPrice", "mostRecent", "biggest", "smallest", "lowestPriceM2", "highestPriceM2" ], "type": "string", "description": "Sorting method", "default": "relevance" }, "minPrice": { "title": "Min price (€)", "minimum": 0, "type": "integer", "description": "Minimum price; 0 = any", "default": 0 }, "maxPrice": { "title": "Max price (€)", "minimum": 0, "type": "integer", "description": "Maximum price; 0 = any", "default": 0 }, "minSize": { "title": "Min size (m²)", "minimum": 0, "type": "integer", "description": "Minimum size in m²; 0 = any", "default": 0 }, "maxSize": { "title": "Max size (m²)", "minimum": 0, "type": "integer", "description": "Maximum size in m²; 0 = any", "default": 0 }, "publicationDate": { "title": "Publication date", "enum": [ "", "Y", "T", "W", "M" ], "type": "string", "description": "Filter by publication recency", "default": "" }, "bedrooms": { "title": "Bedrooms", "uniqueItems": true, "type": "array", "description": "Bedroom counts to include", "default": [], "items": { "type": "string" } }, "bathrooms": { "title": "Bathrooms", "uniqueItems": true, "type": "array", "description": "Bathroom counts to include", "default": [], "items": { "type": "string" } }, "homeType": { "title": "Home type", "uniqueItems": true, "type": "array", "description": "Home subtypes (only with propertyType=homes)", "default": [], "items": { "type": "string" } }, "condition": { "title": "Condition", "uniqueItems": true, "type": "array", "description": "Property condition", "default": [], "items": { "type": "string" } }, "floor": { "title": "Floor", "uniqueItems": true, "type": "array", "description": "Floor positions", "default": [], "items": { "type": "string" } }, "airConditioning": { "title": "Air conditioning", "type": "boolean", "description": "Only show listings with air conditioning", "default": false }, "fittedWardrobes": { "title": "Fitted wardrobes", "type": "boolean", "description": "Only show listings with fitted wardrobes", "default": false }, "lift": { "title": "Lift", "type": "boolean", "description": "Only show listings with a lift", "default": false }, "balcony": { "title": "Balcony", "type": "boolean", "description": "Only show listings with a balcony", "default": false }, "terrace": { "title": "Terrace", "type": "boolean", "description": "Only show listings with a terrace", "default": false }, "exterior": { "title": "Exterior", "type": "boolean", "description": "Only show exterior-facing listings", "default": false }, "garage": { "title": "Garage", "type": "boolean", "description": "Only show listings with garage / parking", "default": false }, "garden": { "title": "Garden", "type": "boolean", "description": "Only show listings with a garden", "default": false }, "swimmingPool": { "title": "Swimming pool", "type": "boolean", "description": "Only show listings with swimming pool", "default": false }, "storageRoom": { "title": "Storage room", "type": "boolean", "description": "Only show listings with storage room", "default": false }, "accessible": { "title": "Accessible", "type": "boolean", "description": "Only show wheelchair-accessible listings", "default": false }, "seaViews": { "title": "Sea views", "type": "boolean", "description": "Only show listings with sea views", "default": false }, "luxury": { "title": "Luxury", "type": "boolean", "description": "Only show luxury listings", "default": false }, "plan": { "title": "Floor plan available", "type": "boolean", "description": "Only show listings with floor plan", "default": false }, "virtualTour": { "title": "Virtual tour available", "type": "boolean", "description": "Only show listings with virtual tour", "default": false }, "customProxyUrl": { "title": "Custom Proxy URL (BYO premium residential)", "type": "string", "description": "Optional: full proxy URL (http://user:pass@host:port). Overrides Apify proxy. Recommended for hardened DataDome targets — Apify residential pool may be burned. Use Decodo / Bright Data / IPRoyal ES residential." }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Apify residential proxy. Defaults to Spain (ES) — change country code to IT or PT when scraping idealista.it / idealista.pt.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "ES" } } } }, "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 } } } } } } } } } } ```