{ "openapi": "3.0.1", "info": { "title": "Trivago Hotel Scraper - Compare Prices & AI Deal Finder", "description": "Scrape Trivago hotel listings with prices from multiple booking sites (Booking.com, Hotels.com, Expedia, Agoda). AI finds the best deals, compares prices, and recommends where to book. The only PPE Trivago scraper on Apify.", "version": "1.0", "x-build-id": "Lx4PGyPztGf1XrTiH" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/buseta~trivago-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-buseta-trivago-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/buseta~trivago-scraper/runs": { "post": { "operationId": "runs-sync-buseta-trivago-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/buseta~trivago-scraper/run-sync": { "post": { "operationId": "run-sync-buseta-trivago-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "destination": { "title": "Destination", "type": "string", "description": "City or destination name. Example: 'Paris', 'New York', 'Tokyo', 'London-England'. Just type the city — we handle the rest." }, "search_url": { "title": "Trivago search URL (advanced, optional)", "type": "string", "description": "Optional: paste a full Trivago URL with specific dates/filters. Overrides the destination field. Get this by searching on trivago.com and copying the URL." }, "max_hotels": { "title": "Max hotels", "minimum": 1, "maximum": 200, "type": "integer", "description": "Maximum number of hotels to scrape.", "default": 25 }, "min_stars": { "title": "Minimum stars", "minimum": 1, "maximum": 5, "type": "integer", "description": "Filter: only include hotels with this many stars or more." }, "min_rating": { "title": "Minimum rating", "minimum": 0, "maximum": 10, "type": "number", "description": "Filter: only include hotels rated this high or above (0-10 scale)." }, "max_price": { "title": "Maximum price per night", "minimum": 1, "type": "number", "description": "Filter: only include hotels at or below this price per night." }, "ai_trip_matcher": { "title": "AI Trip Matcher", "type": "boolean", "description": "Describe your trip below and AI scores every hotel against YOUR specific requirements. Match score, reasons why it fits, concerns, and personalized recommendation. Like having a personal travel agent. Charged at $12 per 1,000 hotels.", "default": false }, "trip_description": { "title": "Describe your trip (for AI Trip Matcher)", "maxLength": 300, "type": "string", "description": "Tell the AI what you need. Example: 'Family trip with 2 kids, need pool, under $120/night, walking distance to attractions, breakfast included.' Max 300 characters." }, "ai_hotel_analysis": { "title": "AI Hotel Analysis", "type": "boolean", "description": "AI evaluates each hotel in depth: value score, who it's best for (families/couples/business/budget), strengths, weaknesses, price verdict, and booking tips. Charged at $6 per 1,000 hotels.", "default": false }, "ai_market_report": { "title": "AI Destination Report", "type": "boolean", "description": "AI analyzes all hotels in this destination: best value/luxury/budget picks, price insights, booking tips, and hotels to avoid. Charged at $3 per 1,000 hotels.", "default": false }, "proxy_config": { "title": "Proxy configuration", "type": "object", "description": "Trivago works without proxy. Enable if you experience issues." } } }, "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 } } } } } } } } } }