{ "openapi": "3.0.1", "info": { "title": "Timeleft Scraper - Events, Dinners & Schedules in 200 Cities", "description": "Scrape Timeleft (timeleft.com) event schedules across 200 cities: dinners, drinks, coffees, runs, walks and brunches with dates, zones, group sizes, booking cutoffs and booking headcounts. Self-registers a free app account; no subscription needed for schedules.", "version": "0.1", "x-build-id": "0riiBfPZFW29aYYTl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/abotapi~timeleft-schedules-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-abotapi-timeleft-schedules-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~timeleft-schedules-scraper/runs": { "post": { "operationId": "runs-sync-abotapi-timeleft-schedules-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~timeleft-schedules-scraper/run-sync": { "post": { "operationId": "run-sync-abotapi-timeleft-schedules-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": { "cities": { "title": "Cities", "type": "array", "description": "City names, numeric ids, or 'City, Country' form, e.g. 'Paris', '209', 'Paris, France'. Minor typos are tolerated and logged as read; abbreviations are not guessed. Every result holds up to ~3 weeks of scheduled sessions per city. Leave empty to sweep all 197 catalog cities (about 1,900 sessions). Unknown cities are skipped with a warning.", "items": { "type": "string" } }, "eventTypes": { "title": "Event types", "type": "array", "description": "Pick one or more formats to include; leave empty for all formats.", "items": { "type": "string", "enum": [ "dinner", "drinks", "coffee", "run", "walk", "brunch" ], "enumTitles": [ "Dinner", "Drinks", "Coffee", "Run", "Walk", "Brunch" ] } }, "maxItems": { "title": "Max items", "minimum": 0, "type": "integer", "description": "Stop after this many sessions across all cities. 0 = unlimited full sweep of the scoped cities (about 1,900 sessions for all 197).", "default": 20 }, "fetchHeadcounts": { "title": "Fetch booking headcounts", "type": "boolean", "description": "Also read per-event booking totals (one extra read per city) into dayUsersBooked (day-level booking totals). Turn off for a lighter run with schedules only.", "default": true }, "accountKey": { "title": "Account key", "type": "string", "description": "Gives each key its own saved state, so hundreds of monitors can run side by side without sharing or racing one. Leave default for single use.", "default": "default" }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "The schedule API answers from any exit; residential is the default for consistency. The actor fails over gracefully when one is refused." }, "resumeFromRunId": { "title": "Resume from a previous run", "type": "string", "description": "Paste a previous run ID or dataset ID to continue one interrupted sweep. Sessions already collected there are skipped. Distinct from Incremental mode below, which tracks the same scope across scheduled runs by itself." }, "incrementalMode": { "title": "Incremental mode (track changes across scheduled runs)", "type": "boolean", "description": "When ON, the actor remembers its sessions from the previous run of the same scope and tags every row with changeType: NEW, UPDATED, UNCHANGED, REAPPEARED or EXPIRED. Use with the Apify Scheduler to monitor schedules over time.", "default": false }, "stateKey": { "title": "State key (optional, incremental mode only)", "type": "string", "description": "A name for this monitor's saved state, e.g. 'paris-dinners'. Leave empty to key the baseline automatically to your exact cities, event types and headcount toggle (changing the scope then starts fresh). Set a key to pin one baseline across runs; use distinct keys for independent monitors." }, "emitUnchanged": { "title": "Emit UNCHANGED sessions (incremental mode only)", "type": "boolean", "description": "When ON, sessions with no detected change are still pushed (tagged UNCHANGED) instead of skipped. This returns, and bills, one extra row per unchanged session.", "default": false }, "emitExpired": { "title": "Emit EXPIRED sessions (incremental mode only)", "type": "boolean", "description": "When ON, sessions tracked before but no longer scheduled after a complete, uncapped scan are pushed once tagged EXPIRED. Only fires on a run that scans its whole scope.", "default": false }, "ignoreFieldsForChanges": { "title": "Ignore fields when detecting changes (incremental mode only)", "type": "array", "description": "Output field names that should NOT mark a session UPDATED. The scrape timestamp is always ignored. Add fields such as dayUsersBooked here if booking-count drift is not relevant to you.", "items": { "type": "string" } }, "mcpConnectors": { "title": "Pipe results into your apps (optional)", "type": "array", "description": "Optionally send the 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 session, 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).", "items": { "type": "string" } }, "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 }, "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 } } } } } } } } } }