{
  "openapi": "3.0.1",
  "info": {
    "title": "Luma Events Scraper - lu.ma Events, Hosts, Tickets & Organizers",
    "description": "Scrape Luma (luma.com, lu.ma) events by city, category, keyword, calendar, host or link: every event near a city, hosts and organizers with socials, ticket prices, guest counts, full description, ticket types. Monitor mode, alerts. $0.027 per 1,000 events, details $0.69 per 1,000.",
    "version": "0.1",
    "x-build-id": "CrETQdV740IsIax36"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/topapi~luma-events-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-topapi-luma-events-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/topapi~luma-events-scraper/runs": {
      "post": {
        "operationId": "runs-sync-topapi-luma-events-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/topapi~luma-events-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-topapi-luma-events-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 or Luma city slugs: \"San Francisco\", \"sf\", \"New York\", \"London\", \"Berlin\", \"Tokyo\". Any of Luma's 87 cities, or any other place name (found by a geocoder). By default every public event near the city is read, not only Luma's featured city page.",
            "items": {
              "type": "string"
            }
          },
          "categories": {
            "title": "Categories",
            "type": "array",
            "description": "Luma's 12 categories. With cities: that category in each city. Without a city: the category across every Luma city.",
            "items": {
              "type": "string",
              "enum": [
                "tech",
                "ai",
                "crypto",
                "arts",
                "food",
                "climate",
                "fitness",
                "wellness",
                "running",
                "books",
                "games",
                "family"
              ],
              "enumTitles": [
                "Tech",
                "AI",
                "Crypto",
                "Arts & Culture",
                "Food & Drink",
                "Climate",
                "Fitness",
                "Wellness",
                "Running",
                "Books",
                "Games",
                "Family"
              ]
            }
          },
          "searchQueries": {
            "title": "Search keywords",
            "type": "array",
            "description": "Luma's own event search, e.g. \"hackathon\", \"ai agents\", \"founders dinner\". With cities: near each city; without: worldwide. Luma shows 50 matches per search; the run reads on by map area (near a city) or city by city (worldwide) when you want more.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Luma links",
            "type": "array",
            "description": "Any luma.com or lu.ma link, mixed: event pages (luma.com/abc123), calendars and communities (luma.com/genai-sf), city pages (luma.com/sf), category pages (luma.com/tech), luma.com/discover, host profiles (luma.com/user/name).",
            "items": {
              "type": "string"
            }
          },
          "calendars": {
            "title": "Calendars / communities",
            "type": "array",
            "description": "Calendar slugs, links or ids, e.g. \"genai-sf\", \"https://luma.com/ycombinator-official\", \"cal-JTdFQadEz0AOxyV\". Upcoming events by default; see Period.",
            "items": {
              "type": "string"
            }
          },
          "hosts": {
            "title": "Hosts",
            "type": "array",
            "description": "Luma usernames, profile links (luma.com/user/name) or usr- ids: the events each host runs.",
            "items": {
              "type": "string"
            }
          },
          "eventUrls": {
            "title": "Event links",
            "type": "array",
            "description": "Event links, slugs (\"8v9rokfj\") or evt- ids. Each comes with its full event record.",
            "items": {
              "type": "string"
            }
          },
          "urlsFromFile": {
            "title": "Links from a list",
            "type": "string",
            "description": "Paste many Luma links or slugs, one per line."
          },
          "period": {
            "title": "Period (calendars and hosts)",
            "enum": [
              "upcoming",
              "past",
              "all"
            ],
            "type": "string",
            "description": "For calendars and hosts. City, category and search feeds list upcoming events only.",
            "default": "upcoming"
          },
          "cityScope": {
            "title": "City feed",
            "enum": [
              "nearby",
              "featured"
            ],
            "type": "string",
            "description": "Nearby: every public in-person event Luma lists around the city (San Francisco 1,065, London 1,200 on 2026-11-06). Featured: the curated city page (77 and 62).",
            "default": "nearby"
          },
          "radiusKm": {
            "title": "Radius (km)",
            "minimum": 0,
            "type": "integer",
            "description": "Keep events within this distance of the city centre or of the point below. 0 = Luma's own area (about 50 km)."
          },
          "latitude": {
            "title": "Latitude",
            "type": "number",
            "description": "Every event near a point (with longitude), e.g. 51.5072."
          },
          "longitude": {
            "title": "Longitude",
            "type": "number",
            "description": "With latitude, e.g. -0.1276."
          },
          "boundingBox": {
            "title": "Map area",
            "type": "object",
            "description": "Every event inside a map rectangle: {\"north\": 51.7, \"south\": 51.3, \"east\": 0.2, \"west\": -0.5}."
          },
          "dateFrom": {
            "title": "Starts on or after",
            "type": "string",
            "description": "Only events starting on or after this date (YYYY-MM-DD). The feed is opened at this date, so earlier events are never read."
          },
          "dateTo": {
            "title": "Starts on or before",
            "type": "string",
            "description": "Only events starting on or before this date. Reading stops past it."
          },
          "daysAhead": {
            "title": "Next N days",
            "minimum": 0,
            "type": "integer",
            "description": "Only events in the next N days (7 = this week)."
          },
          "eventType": {
            "title": "In person / online",
            "enum": [
              "any",
              "in_person",
              "online"
            ],
            "type": "string",
            "description": "Luma's city and map feeds list in-person events; online events come from calendars, hosts, searches and links.",
            "default": "any"
          },
          "pricing": {
            "title": "Free / paid",
            "enum": [
              "any",
              "free",
              "paid"
            ],
            "type": "string",
            "description": "Free or paid registration.",
            "default": "any"
          },
          "minGuests": {
            "title": "Minimum guests",
            "minimum": 0,
            "type": "integer",
            "description": "Only events with at least this many registered guests (Luma's public guest count)."
          },
          "keywordFilter": {
            "title": "Must contain",
            "type": "array",
            "description": "Keep events whose name (or description, with details on) contains any of these words.",
            "items": {
              "type": "string"
            }
          },
          "excludeKeywords": {
            "title": "Must not contain",
            "type": "array",
            "description": "Drop events whose name or description contains any of these words.",
            "items": {
              "type": "string"
            }
          },
          "hideSoldOut": {
            "title": "Hide sold-out events",
            "type": "boolean",
            "description": "Drop events Luma marks sold out.",
            "default": false
          },
          "includeDetails": {
            "title": "Full event details",
            "type": "boolean",
            "description": "Each event's full record: description (text, Markdown, HTML), every ticket type with price and spots, registration questions, categories, contacts and sponsor lines written in the description. Charged per row that gets it. Off = listing rows only.",
            "default": true
          },
          "descriptionFormat": {
            "title": "Description format",
            "enum": [
              "all",
              "text",
              "markdown",
              "html"
            ],
            "type": "string",
            "description": "Which description fields each detailed row carries.",
            "default": "all"
          },
          "descriptionMaxLength": {
            "title": "Description max length",
            "minimum": 0,
            "type": "integer",
            "description": "Cut descriptions to this many characters. 0 = full."
          },
          "includeHostProfiles": {
            "title": "Host profile stats",
            "type": "boolean",
            "description": "Add each host's hosted and attended event counts and Luma join date to the hosts on every row (one look-up per host, no extra charge).",
            "default": false
          },
          "organizerContacts": {
            "title": "Organizer email from their website",
            "type": "boolean",
            "description": "Read the organizer's own website (the link on their Luma calendar): homepage, then contact / about pages, for an email, phones and social links. Charged once per organizer per run, only when an email is found.",
            "default": false
          },
          "outputType": {
            "title": "Rows",
            "enum": [
              "events",
              "calendars",
              "hosts",
              "all"
            ],
            "type": "string",
            "description": "Organizer rows: name, website, socials, event counts (upcoming, past, last 90 days). Host rows: profile, socials, hosted and attended counts.",
            "default": "events"
          },
          "maxItems": {
            "title": "Max results",
            "minimum": 0,
            "type": "integer",
            "description": "Rows in this run, over all sources (events, or organizers / hosts in those modes). 0 = no limit.",
            "default": 100
          },
          "maxItemsPerSource": {
            "title": "Max results per source",
            "minimum": 0,
            "type": "integer",
            "description": "Cap per city, category, search, calendar or host. 0 = no cap."
          },
          "maxPages": {
            "title": "Max pages per source",
            "minimum": 0,
            "type": "integer",
            "description": "50 events a page. 0 = no cap."
          },
          "splitSearches": {
            "title": "Read past Luma's 50-match search cap",
            "type": "boolean",
            "description": "A search that shows 50 matches is read further by map area (near a city) or city by city (worldwide) when the run wants more rows.",
            "default": true
          },
          "searchMatch": {
            "title": "Search matching",
            "enum": [
              "strict",
              "luma"
            ],
            "type": "string",
            "description": "Luma's search always answers with 50 events, even for a word no event uses. Strict drops the ones without the word (before any charge).",
            "default": "strict"
          },
          "maxConcurrency": {
            "title": "Max concurrency",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "Event records read at once.",
            "default": 10
          },
          "monitorMode": {
            "title": "Only new events (monitor)",
            "type": "boolean",
            "description": "Each run delivers (and charges) only events earlier runs with the same input have not delivered. Pairs with a daily schedule.",
            "default": false
          },
          "emitChanges": {
            "title": "Also changed events",
            "type": "boolean",
            "description": "With monitor on: also deliver remembered events whose name, date, price, sold-out or waitlist state, venue or format changed (changeType \"updated\", with previousValues).",
            "default": false
          },
          "monitorStoreName": {
            "title": "Monitor name",
            "type": "string",
            "description": "Keeps separate memories for separate schedules. Empty = one memory per input."
          },
          "firstRunMode": {
            "title": "First monitor run",
            "enum": [
              "emitAll",
              "seedOnly"
            ],
            "type": "string",
            "description": "What the first monitor run does.",
            "default": "emitAll"
          },
          "resetMonitor": {
            "title": "Reset monitor memory",
            "type": "boolean",
            "description": "Forget what earlier runs delivered (one run).",
            "default": false
          },
          "generateIcs": {
            "title": "Calendar file (.ics)",
            "type": "boolean",
            "description": "Also save the delivered events as events.ics in the run's key-value store (Google, Outlook, Apple Calendar).",
            "default": false
          },
          "webhookUrl": {
            "title": "Webhook URL",
            "type": "string",
            "description": "POST the new rows here after the run (n8n, Make, Zapier)."
          },
          "webhookHeaders": {
            "title": "Webhook headers",
            "type": "object",
            "description": "Extra headers for the webhook, e.g. {\"Authorization\": \"Bearer ...\"}."
          },
          "slackWebhookUrl": {
            "title": "Slack webhook",
            "type": "string",
            "description": "Slack incoming-webhook URL."
          },
          "discordWebhookUrl": {
            "title": "Discord webhook",
            "type": "string",
            "description": "Discord webhook URL."
          },
          "teamsWebhookUrl": {
            "title": "Microsoft Teams webhook",
            "type": "string",
            "description": "Teams incoming-webhook URL."
          },
          "telegramToken": {
            "title": "Telegram bot token",
            "type": "string",
            "description": "Your Telegram bot token (with the chat id below)."
          },
          "telegramChatId": {
            "title": "Telegram chat id",
            "type": "string",
            "description": "The chat, group or channel to message."
          },
          "ntfyTopic": {
            "title": "ntfy topic",
            "type": "string",
            "description": "Push to an ntfy.sh topic (or your own server below)."
          },
          "ntfyServer": {
            "title": "ntfy server",
            "type": "string",
            "description": "Default https://ntfy.sh."
          },
          "notificationLimit": {
            "title": "Rows per alert",
            "minimum": 0,
            "maximum": 50,
            "type": "integer",
            "description": "How many events each alert lists.",
            "default": 10
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Empty = direct, then Apify datacenter, then Apify residential if Luma shows a challenge page. Your own proxy goes first."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}