{ "openapi": "3.0.1", "info": { "title": "Trip.com Scraper — Hotels Flights Trains Cars", "description": "Scrape Trip.com hotels, flights, trains, cars, packages & attractions across regional domains (www, UK, JP, PH). Get prices, ratings & listing URLs. Export JSON/CSV. Pay per result — no login.", "version": "0.2", "x-build-id": "AfWCBUL2yYAfaXStj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lentic_clockss~trip-com-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lentic_clockss-trip-com-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/lentic_clockss~trip-com-scraper/runs": { "post": { "operationId": "runs-sync-lentic_clockss-trip-com-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/lentic_clockss~trip-com-scraper/run-sync": { "post": { "operationId": "run-sync-lentic_clockss-trip-com-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": [ "service", "destination" ], "properties": { "service": { "title": "Service / Line of Business", "enum": [ "hotels", "flights", "trains", "cars", "packages", "attractions" ], "type": "string", "description": "Trip.com product line: hotels, flights, trains, cars, packages, attractions.", "default": "hotels" }, "domain": { "title": "Trip.com Domain", "type": "string", "description": "Regional Trip.com host (e.g. www.trip.com, ph.trip.com, uk.trip.com, jp.trip.com).", "default": "www.trip.com" }, "destination": { "title": "Destination", "type": "string", "description": "City/region for hotels/cars/packages/attractions/trains, or arrival airport/city for flights. Optional if regionId is set.", "default": "Bangkok" }, "regionId": { "title": "City ID", "type": "string", "description": "Optional Trip.com city id (e.g. Bangkok=359). Improves hotel SERP precision.", "default": "" }, "origin": { "title": "Origin", "type": "string", "description": "Required for flights (airport code or city). Optional package origin.", "default": "" }, "checkin": { "title": "Check-in / Pickup Date", "type": "string", "description": "YYYY-MM-DD for hotels, cars, packages. Recommended for hotels — without dates Trip.com may return generic availability cards.", "default": "" }, "checkout": { "title": "Check-out / Dropoff Date", "type": "string", "description": "YYYY-MM-DD for hotels, cars, packages. Recommended for hotels with checkin.", "default": "" }, "departureDate": { "title": "Flight Departure Date", "type": "string", "description": "YYYY-MM-DD for flights (and optional trains).", "default": "" }, "returnDate": { "title": "Flight Return Date", "type": "string", "description": "YYYY-MM-DD when tripType=roundtrip.", "default": "" }, "tripType": { "title": "Flight Trip Type", "enum": [ "oneway", "roundtrip" ], "type": "string", "description": "oneway or roundtrip for flights", "default": "oneway" }, "adults": { "title": "Adults", "minimum": 1, "maximum": 10, "type": "integer", "description": "Number of adult travelers", "default": 2 }, "children": { "title": "Children", "minimum": 0, "maximum": 10, "type": "integer", "description": "Number of children", "default": 0 }, "rooms": { "title": "Rooms", "minimum": 1, "maximum": 10, "type": "integer", "description": "Number of hotel rooms", "default": 1 }, "maxResults": { "title": "Max results per search", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum listing rows for this destination, region, or flight route (default 70). Larger values are collected in parts of up to 70 rows. All row types count together. The whole run stops at your maximum total charge. Free Apify plan users: up to 200 rows per run and 10 runs total.", "default": 70 }, "currency": { "title": "Currency", "type": "string", "description": "ISO currency code", "default": "USD" }, "locale": { "title": "Locale", "type": "string", "description": "Trip.com locale tag (e.g. en_US)", "default": "en_US" }, "sort": { "title": "Hotel Sort", "type": "string", "description": "Hotel SERP sort (e.g. RECOMMENDED)", "default": "RECOMMENDED" }, "includeSponsored": { "title": "Include Sponsored Ads", "type": "boolean", "description": "Include sponsored ad cards in results", "default": false }, "enrichDetails": { "title": "Enrich hotel details", "type": "boolean", "description": "Open Hotel Detail pages to collect public phone, email, PostalAddress, and hotel organization fields. Disabled in the Store Test default to keep the one-item smoke within the platform timeout.", "default": false }, "proxyCountry": { "title": "Worker exit country", "type": "string", "description": "Optional ISO country for the hosted worker's control-plane-managed exit (defaults from domain).", "default": "" }, "workerBaseUrl": { "title": "Worker Base URL Override", "type": "string", "description": "Optional HTTPS override for the hosted worker. Only allowlisted hosts are accepted (configured worker host, localhost, or ALLOWED_WORKER_HOSTS). Defaults to Actor env WORKER_BASE_URL.", "default": "" } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }