{ "openapi": "3.0.1", "info": { "title": "Luma Events API — Events by City, Category & Calendar", "description": "Upcoming Luma (lu.ma) events as clean rows: every AI, tech or startup meetup in a city, a category or a calendar, with start time, venue, price, capacity, guest count and organiser calendar. Descriptions and ticket types on request. Host names are never included. No login, no browser.", "version": "0.1", "x-build-id": "ar25bFc5kGCdq4ETI" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/insight.solutions~luma-events-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-insight.solutions-luma-events-api", "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/insight.solutions~luma-events-api/runs": { "post": { "operationId": "runs-sync-insight.solutions-luma-events-api", "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/insight.solutions~luma-events-api/run-sync": { "post": { "operationId": "run-sync-insight.solutions-luma-events-api", "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": { "mode": { "title": "What to read", "enum": [ "place", "category", "calendar", "events", "discover" ], "type": "string", "description": "`place`: a city's upcoming events (luma.com/sf). `category`: the upcoming events of the calendars a category page features (luma.com/ai). `calendar`: one calendar's upcoming events. `events`: the events you link to, in full. `discover`: every city and category Luma lists, with the id and slug to use here — free rows only. Each mode reads only its own list below.", "default": "place" }, "places": { "title": "Cities", "type": "array", "description": "For mode `place`. One city per line: its slug (`sf`, `nyc`, `london`), its link (`https://lu.ma/sf`), its id (`discplace-…`) or its name as Luma shows it (`San Francisco`). Run mode `discover` to list every city.", "items": { "type": "string" } }, "categories": { "title": "Categories", "type": "array", "description": "For mode `category`. Slugs (`ai`, `tech`, `climate`), links (`https://lu.ma/ai`), ids (`cat-ai`) or names (`Food & Drink`). A category is read through the calendars its page features, merged by start time.", "default": [], "items": { "type": "string" } }, "calendars": { "title": "Calendars", "type": "array", "description": "For mode `calendar`. A calendar's slug (`genai-sf`), link or id (`cal-…`). A person's own calendar is read, but its name, link and picture are never included.", "default": [], "items": { "type": "string" } }, "events": { "title": "Events", "type": "array", "description": "For mode `events`. Event links (`https://lu.ma/init-conf`), slugs (`init-conf`) or ids (`evt-…`). Each comes back in full: description, ticket types and categories included.", "default": [], "items": { "type": "string" } }, "keyword": { "title": "Keyword", "type": "string", "description": "Only events whose name contains this word or phrase (whole words, any case: `AI` does not match \"Fair\"). Separate alternatives with commas: `AI, LLM, agents`. With details on, the description is searched too.", "default": "" }, "startAfter": { "title": "Starting on or after", "pattern": "^$|^\\d{4}-\\d{2}-\\d{2}([T ]\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?(Z|z|[+-]\\d{2}:?\\d{2})?)?$", "type": "string", "description": "Only events starting on or after this date. A date (`2026-11-01`) is a calendar day in each event's own timezone; a timestamp (`2026-11-01T18:00:00Z`) is an exact instant, read as UTC when it has no zone." }, "startBefore": { "title": "Starting before", "pattern": "^$|^\\d{4}-\\d{2}-\\d{2}([T ]\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?(Z|z|[+-]\\d{2}:?\\d{2})?)?$", "type": "string", "description": "Only events starting before this date (the day itself excluded): `startAfter` 2026-11-01 and `startBefore` 2026-12-01 is November. Same formats as `startAfter`. Because Luma lists events by start time, a city or calendar stops being read once its events pass this date." }, "locationType": { "title": "In person or online", "enum": [ "any", "offline", "online" ], "type": "string", "description": "`offline` keeps in-person events, `online` keeps the rest.", "default": "any" }, "freeOnly": { "title": "Free events only", "type": "boolean", "description": "Keep only events whose registration is free.", "default": false }, "includeDetails": { "title": "Include details", "type": "boolean", "description": "Add each event's description, ticket types, categories, session, FAQ and registration-question counts and refund policy. One extra request per event, at the same price. Mode `events` always includes them.", "default": false }, "descriptionFormat": { "title": "Description format", "enum": [ "text", "markdown" ], "type": "string", "description": "`text` is clean plain text; `markdown` keeps headings, bold and italic, links, lists and images.", "default": "text" }, "maxEventsPerSource": { "title": "Max events per source", "minimum": 1, "maximum": 10000, "type": "integer", "description": "The most events returned from each city, category or calendar, soonest first. Each one is a paid row; filtered-out events, duplicates and free rows do not count.", "default": 100 }, "maxEventsTotal": { "title": "Max events in all", "minimum": 1, "maximum": 100000, "type": "integer", "description": "The most event rows this run returns across every source.", "default": 1000 }, "maxConcurrency": { "title": "Sources at once", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many sources to read at the same time. Each source is still held to one request at a time, 250–600 ms apart.", "default": 3 }, "maxRunSecs": { "title": "Time budget (seconds)", "minimum": 30, "maximum": 3600, "type": "integer", "description": "Stop after this many seconds. Rows already returned are kept, and a free `timeout` row names each source that was cut short or never started.", "default": 240 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "The capture probe read every Luma endpoint through Apify's datacenter proxy, so that is the default. A refused request is retried once from a fresh address and then becomes a free `blocked` row; switch to residential if that happens often.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }