{ "openapi": "3.0.1", "info": { "title": "Turo Scraper - Vehicle Search, Trip Quotes and Hosts", "description": "Collect Turo vehicles by location and trip dates or listing URLs. Get make, model, year, ratings, photos, dated price estimates, vehicle details and public host profiles, with resume and recurring change detection.", "version": "1.0", "x-build-id": "OCxgAs21lng8L6GXj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/abotapi~turo-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-abotapi-turo-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/abotapi~turo-scraper/runs": { "post": { "operationId": "runs-sync-abotapi-turo-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/abotapi~turo-scraper/run-sync": { "post": { "operationId": "run-sync-abotapi-turo-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": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "url" ], "type": "string", "description": "Search locations or load individual vehicle links.", "default": "search" }, "locations": { "title": "Locations", "type": "array", "description": "Search mode only. City, airport or place names.", "default": [ "Los Angeles, California" ], "items": { "type": "string" } }, "makes": { "title": "Makes", "type": "array", "description": "Search mode only. Vehicle make names, such as Tesla.", "items": { "type": "string" } }, "minYear": { "title": "Minimum model year", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Search mode only. Applied to returned vehicles before the output limit." }, "maxYear": { "title": "Maximum model year", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Search mode only. Applied to returned vehicles before the output limit." }, "minRating": { "title": "Minimum rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Search mode only. Excludes unrated vehicles and applies before the output limit." }, "urls": { "title": "Vehicle URLs", "type": "array", "description": "Turo vehicle or search URLs to scrape. Each URL is one source; vehicle pages are read directly, search pages are forward-paged.", "items": { "type": "string" } }, "startDateTime": { "title": "Trip start", "type": "string", "description": "Both modes. Local ISO date and time without a time zone. Set both dates, or omit both for a three-day trip beginning in seven days." }, "endDateTime": { "title": "Trip end", "type": "string", "description": "Both modes. Local ISO date and time after the start. Must be supplied with the trip start." }, "fetchDetails": { "title": "Full vehicle and host details", "type": "boolean", "description": "Return full specifications and public host profile. One detail-enrichment event is charged after each returned record with a successfully fetched host profile.", "default": true }, "maxItems": { "title": "Maximum vehicles", "minimum": 0, "type": "integer", "description": "Default 20. Zero removes the output limit. Turo can still cap each location at 200 vehicles; this does not imply exhaustive coverage.", "default": 20 }, "proxy": { "title": "Proxy", "type": "object", "description": "Turo blocks datacenter IPs. Use the Residential proxy (default) or bring your own.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }, "resumeFromRunId": { "title": "Resume from run", "type": "string", "description": "Continue an interrupted run with the same query, dates and detail settings. For recurring comparisons, use incrementalMode instead." }, "incrementalMode": { "title": "Incremental mode", "type": "boolean", "description": "Remember a baseline and return changes. Unlike resumeFromRunId, no prior run ID is required. Do not combine with resume when a baseline exists.", "default": false }, "stateKey": { "title": "State key", "type": "string", "description": "Optional baseline name. Use different keys for separate scopes and avoid overlapping runs with the same key." }, "emitUnchanged": { "title": "Include unchanged vehicles", "type": "boolean", "description": "Return and bill unchanged rows in incremental mode.", "default": false }, "emitExpired": { "title": "Include expired vehicles", "type": "boolean", "description": "Return and bill absent rows only after a complete nonempty scan in incremental mode. Capped and partial searches do not expire records.", "default": false }, "mcpConnectors": { "title": "Pipe results into your apps (optional)", "type": "array", "description": "Optionally send the scraped results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize a connector once under Apify -> Settings -> Integrations, then select it here. The connector receives a condensed, human-readable summary per item (title + key fields), not the full JSON; the complete record stays in the dataset. Leave empty to skip. Supported: Notion (https://mcp.notion.com/mcp), Linear (https://mcp.linear.app/sse), Airtable (https://mcp.airtable.com/mcp), Apify (https://mcp.apify.com)." }, "notionParentPageUrl": { "title": "Notion parent page (Notion connector only)", "type": "string", "description": "URL (or id) of the Notion page under which item pages are created. Required to enable the Notion export; ignored by other connectors." }, "maxNotifyListings": { "title": "Max items to export per connector", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Cap on items written to each connector per run. Does not affect the dataset.", "default": 50 } } }, "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 } } } } } } } } } }