# Booking.com Hotels Scraper — Calendar + Delta Monitor (`don.eich/booking-hotels`) Actor Extract Booking.com hotels with pricing, availability calendar (61 days), multi-destination search, and incremental price change monitoring. 17% cheaper than competitors on per-hotel cost ($0.0025 vs $0.003). - **URL**: https://apify.com/don.eich/booking-hotels.md - **Developed by:** [Erick Bonilla](https://apify.com/don.eich) (community) - **Categories:** E-commerce, Travel, Real estate - **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing from $2.50 / 1,000 hotel scrapeds 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 ## Booking.com Hotels Scraper — Calendar + Delta Monitor Extrae hoteles de Booking.com con precios, calendario de disponibilidad (61 días), búsqueda multi-destino y detección incremental de cambios de precio. **Precio base:** `$0.0025` por hotel (17% más barato que el incumbente a `$0.003`). **Diferenciador principal:** calendario diario de precios + modo monitor delta para Revenue Management. --- ### Modos de operación #### SEARCH (modo por defecto) Extrae hoteles para uno o varios destinos con paginación automática. Emite un item `hotel` por propiedad encontrada. ```json { "destinations": ["Barcelona", "Madrid"], "checkin": "2026-09-01", "checkout": "2026-09-03", "adults": 2, "mode": "SEARCH", "maxResults": 100 } ```` #### CALENDAR Para una lista de `hotelIds` (del output de SEARCH), extrae precio y disponibilidad día por día para los próximos 61 días. Ideal para Revenue Management. ```json { "mode": "CALENDAR", "hotelIds": ["es/arts-barcelona", "es/hotel-w-barcelona"], "calendarDays": 61, "currency": "USD" } ``` Formato de `hotelIds` recomendado: `"cc/pageName"` (ej: `"es/arts-barcelona"`). Los valores de `countryCode` y `pageName` están disponibles en cada item del dataset de SEARCH. #### MONITOR Combina SEARCH + CALENDAR + detección de cambios vs snapshot anterior. Emite solo los cambios detectados (`delta-event`). Ideal para programar runs diarios. ```json { "destinations": ["Barcelona"], "mode": "MONITOR", "kvStoreName": "booking-monitor-bcn", "deltaThreshold": 5 } ``` *** ### Output — tipos de item en el dataset El dataset mezcla tres tipos de item diferenciados por el campo `_type`. #### `hotel` — datos del hotel | Campo | Tipo | Descripción | |---|---|---| | `hotelId` | integer | ID interno de Booking.com | | `pageName` | string | Slug de URL (ej: `"arts-barcelona"`) | | `countryCode` | string | ISO 2 letras | | `url` | string | URL canónica del hotel | | `name` | string | Nombre del hotel | | `starRating` | float | 1.0-5.0 (null si no aplica) | | `reviewScore` | float | 0-10 | | `reviewCount` | integer | Número de reseñas | | `priceTotal` | float | Precio total de la estadía en `currency` | | `pricePerNight` | float | Calculado: `priceTotal / nights` | | `priceBeforeDiscount` | float | Precio antes del descuento (null si sin descuento) | | `discountPercent` | float | Porcentaje de descuento calculado | | `currency` | string | ISO 4217 | | `freeCancellation` | boolean | Tiene cancelación gratuita | | `freeCancellationUntil` | string | ISO 8601 deadline | | `isSoldOut` | boolean | Sin disponibilidad para las fechas | | `city`, `country` | string | Ubicación | | `distanceFromCenter` | string | Texto: "1.2 km from centre" | | `isPreferred`, `isPreferredPlus` | boolean | Badges de partner preferido | | `isSustainable` | boolean | Certificado ecológico | | `mealPlan` | string | Ej: "Breakfast included" (null si sin plan) | | `bedTypes` | array | `[{type: string, count: integer}]` | #### `calendar-row` — precio por día | Campo | Tipo | Descripción | |---|---|---| | `hotelId` | integer | ID del hotel | | `date` | string | YYYY-MM-DD (fecha de checkin) | | `available` | boolean | Disponibilidad para ese día | | `price` | float | Precio promedio por noche (null si no disponible) | | `currency` | string | ISO 4217 del input | | `minLengthOfStay` | integer | Noches mínimas requeridas | #### `delta-event` — cambio detectado (solo modo MONITOR) | Campo | Tipo | Descripción | |---|---|---| | `changeType` | string | `PRICE_CHANGE`, `AVAILABILITY_CHANGE`, `NEW_HOTEL`, `HOTEL_REMOVED`, `FREE_CANCELLATION_EXPIRING` | | `previousPrice` | float | Precio en snapshot anterior | | `currentPrice` | float | Precio actual | | `priceDeltaPercent` | float | Cambio porcentual | | `hoursUntilCancellationDeadline` | float | Solo en `FREE_CANCELLATION_EXPIRING` | *** ### Precios (Pay per Event) | Evento | Precio | Cuándo se cobra | |---|---|---| | Actor start | `$0.001` | Una vez por run (automático) | | `hotel-scraped` | `$0.0025` | Por hotel extraído en modo SEARCH/MONITOR | | `calendar-row` | `$0.003` | Por fila de día de calendario | | `delta-event` | `$0.001` | Por cambio detectado en modo MONITOR | **Ejemplos de costo:** - 100 hoteles en SEARCH: `$0.001 + (100 × $0.0025)` = **$0.251** (vs `$0.301` del incumbente) - 100 hoteles con calendario 61 días: `$0.251 + (100 × 61 × $0.003)` = **$18.55** - Run diario de MONITOR sin cambios: `$0.001` (solo el actor-start) *** ### Requisitos técnicos #### Proxies residenciales (obligatorios) Booking.com usa AWS WAF con JS challenge. Las IPs de datacenter reciben `HTTP 202` y no obtienen datos. Configuración recomendada en el input: ```json { "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } } ``` Sin proxies residenciales, el actor retornará 0 resultados. No es un bug del actor — es una restricción de la fuente. #### Memoria mínima 512 MB (el bootstrap de Playwright requiere al menos 512 MB). *** ### Arquitectura técnica **Flujo en dos fases:** 1. **Session Bootstrap (Playwright, 1 vez por run):** Navega a `booking.com/searchresults.html` con proxy residencial, resuelve el JS challenge de AWS WAF, extrae el cookie `aws-waf-token` y el `X-Booking-CSRF-Token`. 2. **Data Collection (HTTP puro con `fetch`):** Pagina `POST /dml/graphql → FullSearch` (25 resultados/página). Para el calendario: `POST /dml/graphql → AvailabilityCalendar` (61 días). Reutiliza la cookie y el token de la Fase 1. El token se refresca automáticamente cada 25 minutos en runs largos. *** ### Límites conocidos - Booking.com limita los resultados de búsqueda a ~1000 propiedades por destino independientemente de la paginación. Para cobertura completa de ciudades grandes (Londres, París), correr con diferentes valores de `sortBy` (POPULARITY, PRICE, REVIEW\_SCORE) y combinar los datasets. - El calendario de precios devuelve máximo 61 días hacia adelante (límite de la API de Booking.com). - El campo `photoUrl` está en `null` — las fotos no están disponibles en el response de FullSearch GQL. Para fotos se requiere una request adicional de detalle de hotel (no implementado en v1.0). *** ### Tasa de éxito y mantenimiento **Tasa de éxito esperada:** 90-95% en runs normales con proxies residenciales. El 5-10% restante corresponde a refrescos de WAF token (automáticos) o IPs del pool que Booking.com bloquea temporalmente. **Mantenimiento:** El actor es monitoreado mensualmente. Los cambios de schema GQL de Booking.com ocurren 1-2 veces por año. Si el actor retorna campos vacíos o falla con "schema validation failed", abrir un issue en el repositorio. *** *** ## Booking.com Hotels Scraper — Calendar + Delta Monitor (English) Extracts Booking.com hotels with pricing, 61-day availability calendar, multi-destination search, and incremental price change monitoring. **Base price:** `$0.0025` per hotel — 17% cheaper than the leading competitor at `$0.003`. **Key differentiator:** daily calendar pricing + delta monitor mode for Revenue Management workflows. ### Quick start ```json { "destinations": ["Barcelona"], "checkin": "2026-09-01", "checkout": "2026-09-03", "adults": 2, "mode": "SEARCH", "maxResults": 100, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } } ``` ### Requirements - **Residential proxies are required.** Booking.com blocks datacenter IPs with an AWS WAF JavaScript challenge. Configure `proxyConfiguration` with `"apifyProxyGroups": ["RESIDENTIAL"]`. - Minimum memory: 512 MB (Playwright session bootstrap). ### Known limits - Booking.com caps search results at approximately 1,000 properties per destination. - Availability calendar returns a maximum of 61 days ahead. - `photoUrl` field is `null` in v1.0 — hotel photos require an additional detail request not yet implemented. # Actor input Schema ## `destinations` (type: `array`): List of destinations to search (city, region, country, or hotel chain name). Example: \["Barcelona", "Madrid"]. Multi-destination runs emit results for all destinations in one dataset. ## `destinationType` (type: `string`): Type hint for destination resolution. If the autocomplete returns a different type, the autocomplete result prevails. CITY covers most use cases. ## `checkin` (type: `string`): Check-in date in YYYY-MM-DD format. Defaults to tomorrow if omitted. ## `checkout` (type: `string`): Check-out date in YYYY-MM-DD format. Defaults to check-in + 2 nights if omitted. ## `adults` (type: `integer`): Number of adults. ## `children` (type: `integer`): Number of children. ## `rooms` (type: `integer`): Number of rooms. ## `currency` (type: `string`): ISO 4217 currency code for prices. USD is the default (more universal for the Apify store). EUR is used by most European users. ## `language` (type: `string`): Language code for labels and text fields in the response. en-gb is recommended as the GQL API returns complete text in this language. ## `sortBy` (type: `string`): Sort order for search results. ## `travelPurpose` (type: `string`): Travel purpose filters property types shown in results. ## `maxResults` (type: `integer`): Maximum number of hotel results per destination. 0 means no limit (paginates until exhausted). Booking.com caps results at approximately 1000 per search regardless of this setting. ## `propertyTypes` (type: `array`): Filter by property type. Leave empty to include all types. Multiple types are iterated in separate sub-searches within the same run. ## `minReviewScore` (type: `number`): Filter results by minimum review score (0-10). Applied to output, not the GQL query. ## `minStarRating` (type: `integer`): Filter results by minimum star rating (1-5). Applied to output, not the GQL query. ## `mode` (type: `string`): SEARCH: snapshot of hotels for a destination. CALENDAR: price and availability per day for a list of hotelIds. MONITOR: SEARCH + CALENDAR + delta detection against previous run snapshot. ## `hotelIds` (type: `array`): Required in CALENDAR mode. List of Booking.com internal hotel IDs (the hotelId field from SEARCH output). Ignored in SEARCH mode. ## `calendarDays` (type: `integer`): Number of days ahead to fetch in the availability calendar. Maximum is 61 (Booking.com API limit). ## `calendarStartDate` (type: `string`): Start date for the availability calendar in YYYY-MM-DD format. Defaults to tomorrow if omitted. ## `deltaThreshold` (type: `number`): Minimum price change percentage to emit a PRICE\_CHANGE delta event. 0 emits any price change. 5 emits only changes greater than 5%. ## `kvStoreName` (type: `string`): Name of the named Key-Value Store used to persist snapshots between runs in MONITOR mode. Use the same name across all scheduled runs for the same destination. ## `includeCalendar` (type: `boolean`): In SEARCH mode, also fetch AvailabilityCalendar for each hotel result. Adds calendar-row items to the dataset. Increases run time approximately 3x. ## `maxConcurrency` (type: `integer`): Maximum concurrent HTTP requests. Booking.com tolerates 5-8 concurrent requests per session without visible rate limiting. ## `requestTimeout` (type: `integer`): Timeout per HTTP request in milliseconds. ## `maxRetries` (type: `integer`): Number of retries per failed request before marking as error. ## `proxyConfiguration` (type: `object`): Proxy configuration. Residential proxies are REQUIRED — Booking.com blocks datacenter IPs with an AWS WAF challenge. Without residential proxies, all requests will return HTTP 202 challenge responses and the actor will produce 0 results. ## Actor input object example ```json { "destinations": [ "Barcelona" ], "destinationType": "CITY", "adults": 2, "children": 0, "rooms": 1, "currency": "USD", "language": "en-gb", "sortBy": "POPULARITY", "travelPurpose": "LEISURE", "maxResults": 100, "propertyTypes": [], "mode": "SEARCH", "hotelIds": [], "calendarDays": 61, "deltaThreshold": 0, "kvStoreName": "booking-monitor", "includeCalendar": false, "maxConcurrency": 5, "requestTimeout": 30000, "maxRetries": 3, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # 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 = { "destinations": [ "Barcelona" ] }; // Run the Actor and wait for it to finish const run = await client.actor("don.eich/booking-hotels").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 = { "destinations": ["Barcelona"] } # Run the Actor and wait for it to finish run = client.actor("don.eich/booking-hotels").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 '{ "destinations": [ "Barcelona" ] }' | apify call don.eich/booking-hotels --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=don.eich/booking-hotels", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Booking.com Hotels Scraper — Calendar + Delta Monitor", "description": "Extract Booking.com hotels with pricing, availability calendar (61 days), multi-destination search, and incremental price change monitoring. 17% cheaper than competitors on per-hotel cost ($0.0025 vs $0.003).", "version": "1.0", "x-build-id": "kXtik47gFl3rODhff" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/don.eich~booking-hotels/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-don.eich-booking-hotels", "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/don.eich~booking-hotels/runs": { "post": { "operationId": "runs-sync-don.eich-booking-hotels", "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/don.eich~booking-hotels/run-sync": { "post": { "operationId": "run-sync-don.eich-booking-hotels", "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": { "destinations": { "title": "Destinations", "type": "array", "description": "List of destinations to search (city, region, country, or hotel chain name). Example: [\"Barcelona\", \"Madrid\"]. Multi-destination runs emit results for all destinations in one dataset.", "items": { "type": "string" }, "default": [] }, "destinationType": { "title": "Destination type", "enum": [ "CITY", "REGION", "COUNTRY", "DISTRICT", "AIRPORT" ], "type": "string", "description": "Type hint for destination resolution. If the autocomplete returns a different type, the autocomplete result prevails. CITY covers most use cases.", "default": "CITY" }, "checkin": { "title": "Check-in date", "type": "string", "description": "Check-in date in YYYY-MM-DD format. Defaults to tomorrow if omitted." }, "checkout": { "title": "Check-out date", "type": "string", "description": "Check-out date in YYYY-MM-DD format. Defaults to check-in + 2 nights if omitted." }, "adults": { "title": "Adults", "minimum": 1, "maximum": 30, "type": "integer", "description": "Number of adults.", "default": 2 }, "children": { "title": "Children", "minimum": 0, "maximum": 10, "type": "integer", "description": "Number of children.", "default": 0 }, "rooms": { "title": "Rooms", "minimum": 1, "maximum": 30, "type": "integer", "description": "Number of rooms.", "default": 1 }, "currency": { "title": "Currency", "type": "string", "description": "ISO 4217 currency code for prices. USD is the default (more universal for the Apify store). EUR is used by most European users.", "default": "USD" }, "language": { "title": "Language", "type": "string", "description": "Language code for labels and text fields in the response. en-gb is recommended as the GQL API returns complete text in this language.", "default": "en-gb" }, "sortBy": { "title": "Sort by", "enum": [ "POPULARITY", "PRICE", "REVIEW_SCORE", "DISTANCE" ], "type": "string", "description": "Sort order for search results.", "default": "POPULARITY" }, "travelPurpose": { "title": "Travel purpose", "enum": [ "LEISURE", "BUSINESS" ], "type": "string", "description": "Travel purpose filters property types shown in results.", "default": "LEISURE" }, "maxResults": { "title": "Max results (per destination)", "minimum": 0, "type": "integer", "description": "Maximum number of hotel results per destination. 0 means no limit (paginates until exhausted). Booking.com caps results at approximately 1000 per search regardless of this setting.", "default": 100 }, "propertyTypes": { "title": "Property types", "type": "array", "description": "Filter by property type. Leave empty to include all types. Multiple types are iterated in separate sub-searches within the same run.", "items": { "type": "string", "enum": [ "HOTEL", "APARTMENT", "HOSTEL", "VILLA", "RESORT", "GUESTHOUSE", "BED_AND_BREAKFAST", "MOTEL" ] }, "default": [] }, "minReviewScore": { "title": "Minimum review score", "minimum": 0, "maximum": 10, "type": "number", "description": "Filter results by minimum review score (0-10). Applied to output, not the GQL query." }, "minStarRating": { "title": "Minimum star rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Filter results by minimum star rating (1-5). Applied to output, not the GQL query." }, "mode": { "title": "Operation mode", "enum": [ "SEARCH", "CALENDAR", "MONITOR" ], "type": "string", "description": "SEARCH: snapshot of hotels for a destination. CALENDAR: price and availability per day for a list of hotelIds. MONITOR: SEARCH + CALENDAR + delta detection against previous run snapshot.", "default": "SEARCH" }, "hotelIds": { "title": "Hotel IDs (CALENDAR mode)", "type": "array", "description": "Required in CALENDAR mode. List of Booking.com internal hotel IDs (the hotelId field from SEARCH output). Ignored in SEARCH mode.", "items": { "type": "string" }, "default": [] }, "calendarDays": { "title": "Calendar days ahead", "minimum": 1, "maximum": 61, "type": "integer", "description": "Number of days ahead to fetch in the availability calendar. Maximum is 61 (Booking.com API limit).", "default": 61 }, "calendarStartDate": { "title": "Calendar start date", "type": "string", "description": "Start date for the availability calendar in YYYY-MM-DD format. Defaults to tomorrow if omitted." }, "deltaThreshold": { "title": "Delta threshold (%)", "minimum": 0, "maximum": 100, "type": "number", "description": "Minimum price change percentage to emit a PRICE_CHANGE delta event. 0 emits any price change. 5 emits only changes greater than 5%.", "default": 0 }, "kvStoreName": { "title": "KV store name (MONITOR mode)", "type": "string", "description": "Name of the named Key-Value Store used to persist snapshots between runs in MONITOR mode. Use the same name across all scheduled runs for the same destination.", "default": "booking-monitor" }, "includeCalendar": { "title": "Include calendar in SEARCH mode", "type": "boolean", "description": "In SEARCH mode, also fetch AvailabilityCalendar for each hotel result. Adds calendar-row items to the dataset. Increases run time approximately 3x.", "default": false }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum concurrent HTTP requests. Booking.com tolerates 5-8 concurrent requests per session without visible rate limiting.", "default": 5 }, "requestTimeout": { "title": "Request timeout (ms)", "minimum": 5000, "maximum": 120000, "type": "integer", "description": "Timeout per HTTP request in milliseconds.", "default": 30000 }, "maxRetries": { "title": "Max retries", "minimum": 0, "maximum": 10, "type": "integer", "description": "Number of retries per failed request before marking as error.", "default": 3 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy configuration. Residential proxies are REQUIRED — Booking.com blocks datacenter IPs with an AWS WAF challenge. Without residential proxies, all requests will return HTTP 202 challenge responses and the actor will produce 0 results.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } } ```